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Introduction 


NOTHING short of a revolution in personal computing has taken place since the 
introduction of the IBM PC in the fall of 1981. Who would have dreamed that PC 
users would be printing spreadsheets spanning several pages, managing 30 mega- 
bytes of hard disk files, attaching electronic notes to databases, sketching out 
memos on pop-up notepads, or controlling another PC over the phone lines? 

The PC users soon discovered that DOS and many popular application pro- 
grams lacked the shortcuts and features they wanted to make computing more 
efficient, streamlined, and simplified. They found assistance from batch files, 
patches to programs—and small utility programs which extended the potential of 
their hardware and application software and solved problems created by the com- 
puter itself. 

The purpose of this book is to provide a compendium of the most useful and 
valuable public domain and commercial utility programs. These programs pro- 
vide a whole new world of tantalizing options to make your work faster, better, 
and easier. Although utilities are not absolute necessities for running a computer, 
nor a reason in and of themselves to own one, the power-user can’t function with- 
out their assistance. 


Types of Utility Programs 


Utilities are distributed as commercial, shareware, and public domain pro- 
grams. The commercial utilities include such popular programs as SideKick, 
Prokey, and FastBack, the best of which are reviewed in each chapter in a com- 
mercial program section. For these programs, only a short summary of the most 
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important features and a comparison with similar software are provided, because 
the purchaser of these programs will be provided with full documentation. 

Shareware or User-Supported Software is a revolutionary concept in soft- 
ware distribution pioneered by Andrew Fluegelman in 1982. It has become a 
major force in the software industry, helping to drive prices lower and eliminate 
copy protection. Although shareware is copyrighted, users are encouraged to 
copy programs and share freely with others. One has the luxury of experimenting 
with the full-featured program at home or in the workplace. If you find the pro- 
gram to be useful, you are trusted to send the author a registration fee. This often 
entitles you to the latest program update, bound documentation, or technical 
assistance. Users are encouraged to remit registration fees to spur development of 
more shareware by rewarding authors for their considerable expense of time and 
expertise. 

Public domain programs are available from many electronic bulletin boards 
and software suppliers. These programs have been placed in the public domain 
for free distribution without any obligation. The authors are often unknown if 
they did not include their name within the program code. Many of these pro- 
grams do not supply adequate documentation for effective use..For all public 
domain and many shareware programs noted in The Best of Shareware: IBM PC 
Utilities, complete documentation of the features and limitations are available 
from this book. This eliminates the difficulty of reviewing documentation on a 
disk file and can provide a quick overview of the available features for each pro- 
gram. In addition, the Appendix provides a listing of many public domain and 
shareware program distributors to which you may write for a catalog. 

Many public domain and shareware programs accomplish the same tasks of 
commercial utilities, without all the frills or the price. In some cases, they may 
even do a better job than the commercial counterpart! Most, however, are not 
designed to be user-friendly. Worse yet, some public domain programs available 
from electronic bulletin boards and software suppliers don’t have all the bugs 
worked out and could potentially cause catastrophic data loss on your hard disk 
or result in a system crash. The programs selected for inclusion in this book have 
largely withstood the test of time for programming bugs, although no guarantee 
can be given or responsibility taken by the program author. Having the complete 
documentation and examples available for ready reference in this book will 
reduce the likelihood of errors in using these utilities and partly compensate for 
their user-unfriendliness. 

Although some utilities are designed to enhance one specific program, most 
are usable across your entire range of software. Some require particular hardware 
configurations; these are noted in the description of each program. Almost all the 
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programs are usable on an IBM PC/XT/AT or compatible with a monochrome or 
graphics display board, 512K memory, and floppy or hard disk drive. 

Many of the utilities discussed in this book provide overlapping functions. 
They are included and compared to allow you to determine which program 1s best 
for your application. 

Many PC users find that it is helpful to place their most frequently used utili- 
ties in a Separate subdirectory on hard disk (or on a separate floppy disk for ready 
access). The DOS PATH command is then used to provide access to this utility 
subdirectory at all times; most users insert this command in their AUTOEXEC- 
.BAT file. Some commercial utilities create their own subdirectory during the 
installation process, and some are designed to look for certain file names in a 
particular directory. For these programs, you may not be able to choose the direc- 
tory in which to locate them. 


Chapter Overview 


Chapter | discusses file management utilities including programs to transfer, 
recover, or compress files. Many of these tasks are difficult or impossible to per- 
form using DOS alone. 

Chapter 2 discusses keyboard and screen enhancing programs including pro- 
grams that change the cursor speed, allow you to set screen colors, and increase 
the type-ahead keyboard buffer. 

Chapter 3 discusses printer utilities and includes information on sideways 
printing of spreadsheets, obtaining special features from the printer, and 
enhanced control over its functions. 

Chapter 4 describes disk maintenance; backup and hard disk utilities that 
allow you to cope with hardware failure or inefficiency, and back up your hard 
disk faster than DOS; and improved methods for managing your hard disk. 

Chapter 5 notes clock and calendar utilities. 

Chapter 6 concerns programming, debugging, and diagnostic utilities, 
allowing easier access to RAM or files on disk, programming shortcuts, and 
evaluation of hardware problems. 

Chapter 7 describes operating system enhancements that patch and extend 
DOS to make it more streamlined and capable. 

Chapter 8 discusses batch file utilities that allow new, useful commands to 
be added to your batch files. 

Chapter 9 is a potpourri of miscellaneous utilities, including programs to jog 
your memory, unprotect programs, create a RAMdisk, and jot electronic notes. 
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TSR Programs 


Some utility programs are designed to load into memory and then terminate 
and stay resident (TSR) until summoned by pressing a special combination of 
keys. These programs remain in RAM by not releasing the memory they occupy 
for use by other software. Examples of TSR utilities include DOS shells, pro- 
grams to create or perform macros, take notes, dial phone numbers, manage 
data, and just about any other application you might want to access while in the 
middle of another program. 


Text Conventions 


Key names often referred to in the text include: 


Up The up-arrow key on the numeric keypad. 
Down The down-arrow key on the numeric keypad. 
Left The left-arrow key on the numeric keypad. 
Right The right-arrow key on the numeric keypad. 


Backspace The large left-arrow key. 


A caret (*) means to press the Ctr] key in conjunction with a named key; for 
example, “End means ‘“‘press and hold the Ctrl key, then press End.” Similarly, 
an ‘‘@’’ means to press the Alt key in conjunction with a named key. 

Words in [brackets] are optional elements of a command. 
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File Management Utilities 


THIS CHAPTER discusses file management utilities including programs to 
transfer, recover, and compare files. Searching and sorting files, management of 
memory-resident utilities, and path utilities are also discussed. These tasks are 
difficult or impossible to perform using DOS alone. 


File Management Utilities 


CMOVE.COM 


Purpose Move a file or group of files from one directory to another. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features CMOVE is a smart file-moving utility which moves 
files between directories, but will not move a file if the same file is already 
present in the target directory. The command format is 


CMOVE source target [option] 


where the option is to disable the file comparison feature and move the file any- 


way, specified as “‘-i’’. 


Examples CMOVE a:*.* b:*.* may be used to transfer all files on drive a: to 
drive b: 


CMOVE \ lotus \ *.dat \ wksheet would transfer all files in directory 
“‘lotus”’ having the extension “‘.dat”’ to the directory ‘“wksheet”’ 


CMOVE A: \ bill \ *.* c: \. -i would move all files in directory “‘bill”’ on 
drive A: to the C: drive even if the same files already exist on C: 


Author/Source: Daniel Doman 
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COMPARE.COM 


Purpose Compare two ASCII files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features COMPARE.COM is an improved version of IBM’s 
COMP program which compares two ASCII files and points out the differences 
between them. Each difference detected will cause the display of a screen show- 
ing the differing sections of each file. Only 75 characters are displayed for each 
line to avoid an unreadable screen display. The first line displayed for both files is 
the one that didn’t compare exactly. The user may continue the comparison at 
these points by choosing new starting lines for each file or quit the comparison by 
pressing Escape. The program continues until the end of file is reached on one or " 
both files. A count of the total lines having differences is reported at the end. A 
typical use of COMPARE would be to determine differences between two ver- 
sions of a program source or a manuscript. The format for the command is: 


COMPARE filename! filename2 


or the program will prompt the user for filenames if these are not specified. To 
end the program prematurely, press Ctrl-Break. 


Example 
COMPARE FILE1.DOC FILE2.DOC 


Author/Source Paul Wasserman, The Software Works, P.O. Box 1867, 
Pleasanton, CA 94566. 
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DPATH.COM 


Purpose Allows a program to have directory search capability. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features DPATH gives programs a directory path search capa- 
bility to find data files and program overlays. This is especially useful for hard 
disks so that copies of overlays for programs such as WordStar need not be kept in 
each directory where the program is used. 

To use DPATH, type DPATH followed by a series of path names separated 
by semicolons (the same syntax as used by the DOS 2.X PATH command). The 
first time DPATH is typed after booting, the message ‘Resident part of DPATH 
loaded’ appears and the size of DOS decreases by 544 bytes. After this, when a 
program opens a file for reading, the file will be searched for in the current direc- 
tory. If it is not in the current directory, it will be searched for in the directories 
specified in the last DPATH command (in the order that they were specified). 
Files that are opened for writing will be opened in the current directory. 

To set a new data path search, enter DPATH followed by a new list of paths. 
Those new paths will replace the old ones. If DPATH ; is entered, all search 
paths will be reset. 

If DPATH is entered with no argument, the current search paths are dis- 
played. 


Restrictions § DPATH will work with most (but not all) programs that are writ- 
ten to work under DOS 1.1. It will not work with most programs that run only 
under DOS 2.X. Whether a program works or not is determined by how it opens 
files that it uses. 


Example 
DPATH C: \ WORDSTAR \ TEXT;C: \ LASERFONT;B: \ 


would allow access to the above directories from a program on the default A: 
drive. 


Author/Source David Micon (Compuserve ID# 74216,2045) 
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GREP. EXE 


Purpose Search for strings in one or more files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features GREP (named after its UNIX counterpart) is a utility 
which locates all occurences of a user-specified string in one or a group of files. 
The files to be searched are specified by one or more filespecs (which may con- 
tain wildcard characters) following the search string on the command line. All 
GREP searches are case-sensitive. Format for the command is: 


GREP string filel | file2] 
Example 
GREP IBM-PC TEXT.DOC,TEXT2,DOC 


Author/Source Unknown. 
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MOVE.COM 


Purpose Move files from one directory to another in one step. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features MOVE is a program which combines the COPY and 
DELETE commands—it copies a program from one directory to another. After 
copying, the file is automatically deleted from the original directory. The pro- 
gram prompts the user file by file. The syntax for the command is: 


MOVE [SourceDir|FileSpec [TargetDir] [OptionList] 
OptionList: 


/Erase -Erase_ Erase each file after successful copy. 
/Terse -Terse Suppress version message, instructions. 
/Yes - Yes Automatic ‘‘Yes”’ response to each query. 


Examples 
1) Copy using full directory specifications: 
C> MOVE C:\ DIRA\ *.* C.\ DIRB: 


[MOVE Version 1.00] 
Press Y to copy, N to skip, ESC to stop. 


Copy ABCD.DOC? Yes 
Copy MNOP.DOC? Stop 


2) Copy from A: to current disk and directory, and delete each file after it’s 
moved. 


C> MOVE A:*.* /E 


[MOVE Version 1.00] 
Press Y to copy, N to skip, ESC to stop. 


Copy and erase ABCD.DOC? Yes 
Copy and erase EDGHI.DOC? No 
Copy and erase MNOP.DOC? Stop 


Author/Source Public Domain 1984 by Lewis Haupt, P.O. Box 25363, 
Houston, TX 77265 


File Management Utilities 


MOVE1.COM 


Purpose Moves a file between directories without copying data. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features MOVE is an excellent utility which makes use of the 
DOS function call 56H to rename a file across directories. Files are “moved’’ 
between directories without performing any physical data transfer. Although this 
method of moving files is very efficient, it does not allow transfers between dif- 
ferent drives. If the To and From paths are the same, this command acts as a 
straight RENAME. 

The syntax of the MOVE1 command is: 


MOVE]! \ path \ name.ext \ path \ name. ext 


where the first operand is the From path \ name, and the second operand is the 7o 
path \ name. 


Example 
MOVE]! \ WORD \ TEXT.DOC \ WP \ TEXT.DOC 
Author/Source Original by Mike Turner, modified by Brian Pierce. 
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SEARCH.COM 


Purpose Improved version of DOS PATH command allowing access to all 
types of files. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SEARCH is an extremely valuable utility program for 
anyone who uses DOS 2.0 through 3.x with subdirectories on a fixed disk. 
SEARCH is a general-purpose replacement for the DOS PATH command, but it 
is much more powerful and useful than PATH. Unlike PATH, which is limited to 
batch and executable files, SEARCH allows a user to access files of all types. 
SEARCH works with arbitrary programs on arbitrary files. Data files, overlay 
files, help files, batch files, executable files, text files, program files, object files 
and library files all become accessible with SEARCH. 

Once SEARCH is loaded, it remains resident and occupies approximately 
1K of memory. SEARCH is compatible with versions 2.0 through 3.x of both 
PC-DOS and MS-DOS. 

SEARCH’s command syntax is similar to PATH’s. The SEARCH list is set 
with a command of the form SEARCH =[d:]path{[ [;[d:]...]. SEARCH with no 
arguments displays the current SEARCH list. SEARCH followed by a semicolon 
clears the current SEARCH list. In addition, SEARCH will be deactivated (but 
will retain its current SEARCH list) if SEARCH /D is issued. SEARCH /A will 
activate a previously deactivated SEARCH. 

Simple DOS-style command line editing of the current SEARCH list is avail- 
able via SEARCH /E. Finally, SEARCH /H produces the following list of avail- 
able SEARCH functions: 


Seb cette eee tetas SEARCH[d: ]path{[ [;[d:]path]...] 
(1 are ee Bra SEARCH; 

Display 2.334654 oeetercte SEARCH 

Activate ........0c cece eee SEARCH /A 

Deactivate .........5c000- SEARCH /D 

Edit (with function keys)... SEARCH /E 

Helo: wacsarecne- deg Gesde as SEARCH /H 

License Information ....... SEARCH /L 

Usage Notes 


1) It is advisable for users to make a PATH assignment to the directory contain- 
ing SEARCH.COM in their AUTOEXEC.BAT files, for example, PATH = \ 
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with SEARCH.COM on the root directory, or PATH = \ BIN with SEARCH- 
.COM on \BIN. Thus, SEARCH can always be found even if disabled or 
undefined. 

2) With the single exception noted above, users of SEARCH can ignore the DOS 
PATH command and rely strictly on SEARCH. 

3) If both a SEARCH list and a PATH are specified, the SEARCH list specifica- 
tion will always be attempted first. The PATH will not be invoked unless the 
SEARCH is unsuccessful and then just for batch or executable files. 

4) The SEARCH /E facility will not behave properly if another program has 
changed the normal DOS interpretation of the function keys. 

5) In general, if a program appears to be incompatible with SEARCH, a user can 
1) issue SEARCH /D (to deactivate SEARCH); 2) run the program; 3) issue 
SEARCH /A (to reactivate SEARCH). 


Example 
SEARCH =C: \ WORDSTAR \ TEXT;C: \ LASERFONTS;A: \ 
would allow access to all types of files in the above named directories. 


Author/Source Copyright (©) 1984 Arborsoft Systems, Inc., P.O. Box 4599, 
Ann Arbor, Michigan 48106. Satisfied users of SEARCH are requested to pay a 
$15 license fee. Corporations and other organizations may pay a $100 license fee 
for unlimited business or personal use of SEARCH. 
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SORTF.COM 


Purpose Sorts an ASCII file in ascending order and writes to another file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features This command reads data from an ASCII file, sorts the 
records, and writes the data to another file. The command format is: 


SORTF [d:] [path]fname[.ext] [d:] [path]fname[.ext] [/R] [/nnn] 


Records that are read from the input file, ending with a carriage return and line 
feed, are considered logical records and may be up to 256 characters in length. 
The records are sorted into ascending ASCII character order, unless /R is sup- 
plied to reverse the order. The key is taken from the first character position, 
unless the /+ operand is used to specify the location of the key within the 
records. The position may be a value from one to 255. The first 12 characters at 
that position are used as the record key. 

Depending on the amount of memory available, up to 40000 records, or a 
file up to 16-Mb, may be sorted. The advantages of using SORTF instead of the 
SORT filter are: files larger than 63K may be sorted, and less time is required. 
For best results, place the input file on the fastest available drive, e.g. RAM- 
disk. 


Example _ To sort a file in descending order with the keys in position 10 type 
SORTF TEXT.DAT TEST.SRT /R/+ 10 


Author/Source AAI Systems, Inc., c/o Vernon D. Buerg, 456 Lakeshire 
Drive, Daly City, CA 94015 
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SWEEP.EXE 


Purpose Execute specified command in all directories on disk. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SWEEP will execute a specified DOS command in all 
directories starting with the current directory and moving downward. To execute 
a command in every directory on disk, change the current directory to the root 
directory and invoke SWEEP. 


Example One typical usage of SWEEP would be to erase all files with a file 
extension of .BAK by issuing the command: 


SWEEP *.BAK 


Author/Source Unknown. 
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TSR UTILITIES 


Purpose Manager for memory-resident programs. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features The TSR Utilities include programs useful in managing 
DOS memory, and in particular managing memory-resident utilities. Some util- 
ity programs are designed to load into memory and then terminate and stay resi- 
dent (TSR) until summoned by pressing a special combination of keys. These 
programs remain in RAM by not releasing the memory they occupy for use by 
other software. Examples of TSR utilities include DOS shells, programs to create 
or perform macros, take notes, dial phone numbers, manage data, and just about 
any other application you might want to access while in the middle of another 
program. 

You may have more than one TSR utility in memory simultaneously, 
although they often don’t like each other. With only a limited number of “‘hot- 
keys”’ available on the keyboard, it is not uncommon for two TSR programs to 
have the same one. Fortunately, most of the newer programs give the user the 
option of which keystrokes will bring up a program. It is also important to load 
these RAM resident utilities in proper order, but it is not always obvious how to 
accomplish this. Many TSR programs specify in the documentation that they 
should be loaded last or first, or that loading order does not matter. Loading 
order is important to reduce interference between different TSR utilities which 
can result in not being able to access some of the utilities using the keyboard, 
gaps in memory, or a system freeze-up. If the documentation is unclear or more 
than one program says that it should be loaded last, you will have to experiment 
with the combinations and permutations of loading to determine the most accept- 
able order. In general, print spoolers, RAM drives, and peripheral hardware 
device drivers that do not interact with the keyboard should be loaded first. Next, 
keyboard macro utilities should be loaded. Lastly, load your main application 
program. The TSR utilities are designed to manage your use of multiple mem- 
ory-resident programs. 


Overview 


The TSR Utilities include 7 programs. Here’s a quick overview of each one: 


MARK - marks a position above which TSRs can be released. 
RELEASE - removes TSRs from memory. 
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FMARK - performs the same function as MARK but uses less memory. 
MAPMEM - shows what memory resident programs are loaded. 
WATCH - a TSR itself, it keeps detailed records of other TSRs. 
DISABLE - disables or reactivates TSRs kept in memory. 

RAMEFREE - shows how much RAM memory is available. 


MARK, FMARK and RELEASE 


MARK.COM and RELEASE.COM are used to remove memory-resident 
programs from memory, without requiring a system reboot, and without the 
usual problems of creating holes or leaving interrupts dangling. The two pro- 
grams are used simply as follows: 


1) Run the program MARK.COM before installing any memory-resident pro- 
gram that you may wish to de-install later. This marks the current position in 
memory and stores the DOS interrupt vector table (all interrupts from 0 to 
FFH). 

2) Install whatever TSRs that you want to use, in the normal way that you install 
them. 

3) When you want to de-install all TSRs above the last MARK, run the program 
RELEASE.COM. This will release all of the memory above (and including) 
the last MARK, and restore all interrupt vectors taken over by the memory 
resident programs. 


MARK and RELEASE can be “stacked” as many times as desired. 
RELEASE releases the memory above the last MARK call. MARK uses about 
1600 bytes of memory each time it is called. This 1600 byte region is also 
released when a RELEASE is done. MARK memory usage is dominated by the 
copies of the DOS interrupt vector table (interrupts 0..FFh) and the copy of the 
EMS page map (blocks 0..31 only) which MARK keeps when it goes residenit 

MARK and RELEASE can optionally be called with a single command line 
parameter: | 


MARK MarkName 
RELEASE MarkName 


In this way a particular mark is given a name. Calling RELEASE with the same 
name will release all memory above and including the mark of that name, also 
releasing any intermediate marks in the process. If no mark of the proper name is 
found, RELEASE will halt with a warning. A RELEASE call with no 
MarkName specified will release the last MARK, whether or not that MARK 
was named. 
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The MarkName can be any text string up to 126 characters in length. It may 
not contain embedded blanks or tabs. Case (upper or lower) is not important 
when matching MarkNames. 

MarkName supports an additional feature. If the MarkName begins with ! 
(exclamation point), then the mark is called a “protected mark.” That mark can 
be released only by an exact match to its name (including the exclamation point). 
A protected mark will NOT be released with an “unnamed” RELEASE. Any 
named or unnamed RELEASE will stop without releasing any memory if it 
encounters a protected mark that it does not match exactly. 

MARK and RELEASE also control Expanded memory (Lotus/Intel/Micro- 
soft EMS). They have been tested with READY! and with the Turbo- 
Power Software expanded memory disk cache, as well as with the device drivers 
used by the STB Expanded Memory Card. 

A new form of marking, called a “file mark,” is also supported. The new 
mark has the advantage that it uses only about 150 bytes of memory rather than 
the 1600 of MARK. 

The new mark is placed with the command 


FMARK [d:] [directory]|filename 


The bulk of the vector table and EMS page map are stored in the file which you 
specify on the command line rather than in memory. Note that a command line 
parameter is required in this case. Otherwise FMARK will halt with an error. 
The file created by FMARK will be between 1000 and 2000 bytes in size, 
depending on usage of expanded memory. 

If you will switch drives or directories after using FMARK, you should 
specify a complete pathname when FMARK is initially called. To avoid confu- 
sion, you might want to keep the FMARK files in the root directory, or in a sepa- 
rate directory defined just for this purpose. 

The RELEASE program can release either an in-memory mark (placed by 
MARK.COM) or a file mark (placed by FMARK.COM). Use of RELEASE 
with in-memory marks is described above. To use RELEASE with file marks, 
call it with the name of the mark file on the command line: 


RELEASE [d:] [directory] filename 


In this case the filename must be specified on the command line, and only a file 
mark exactly matching the command line will be released. If the specified mark 
file is not found, RELEASE will halt with an error message. When the memory 
is released, the mark file is also deleted from disk. 

There is no direct equivalent of protected marks for FMARK. If an unnamed 
RELEASE finds an in-memory mark below a file mark, the file mark will be 
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released in the process of the unnamed release. In this case, the marked file will 
not be deleted from disk. 

Other features of RELEASE are activated by command line switches. The 
valid switches are as follows: 


/K release memory above the specified MARK, but Keep the MARK itself in 
memory. This switch is useful if you plan to reinstall the released TSRs later. 


/R_ Revector the 8259 interrupt controller(s) to powerup state. This option is 
useful for TSRs that patch into the system at a very low level. Examples include 
network operating system shells, multitaskers, etc. Use this option with caution; 
that is, test it at a time when no useful work is loaded into memory. 


/? Show a brief help screen and halt. 


MAPMEM and WATCH 


MAPMEM.COM is used to display the current DOS memory map. It shows 
the resident programs, how much memory they use, and what interrupt vectors 
each currently controls. MAPMEM also shows information about expanded 
memory when such a driver is installed. MAPMEM writes to the standard output 
— thus the output can be printed or stored to a file by using DOS redirection. 

MAPMEM shows MARKs and FMARKs so that you can examine them 
prior to a RELEASE. A MARK will show the owner name ““MARK’”’, and the 
mark name (if any) in the command line area. An FMARK will show “N/A” in 
the owner column (due to the minimal memory kept by an FMARK), and the 
name of the mark file in the command line area. 

MAPMEM supports the following command line options: 


/V__ Verbose report. 
/? Write a brief help screen. 


MAPMEM accepts either ‘‘/” or “‘-’’ to delimit the command line options. 
On the Verbose report, the “‘Files’” column shows the number of file handles that 
each resident block has kept open. Each block of memory reported by DOS is 
listed individually in verbose mode. This is useful in debugging problems, either 
with the TSR Utilities themselves, or perhaps with the resident programs that 
you are using. 

By default, each “‘hooked vector” that MAPMEM reports shows only the 
current owner of the vector. Any previous owners now chained onto the list are 
not shown. Because of the technique used, MAPMEM might report some bogus 
hooked vectors (generally high numbered ones). If WATCH has been installed, 
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however, MAPMEM reads the WATCH information area in memory and shows 
the vectors for which any TSR gains control. 

WATCH.COM is a resident program that keeps track of other memory resi- 
dent programs. As a TSR goes resident, WATCH updates a data area in memory 
that contains information about what interrupt vectors were taken over. This 
information can later be used by MAPMEM and DISABLE to show more details 
about interrupts than normally available. Installation of WATCH.COM is 
optional. All of the TSR Utilities except DISABLE can be used whether or not 
WATCH is installed. 

If you want to use it, WATCH.COM should be installed as the first TSR in 
your AUTOEXEC.BAT file. WATCH uses about 4000 bytes of memory when it 
is installed. Most of this memory holds various information about the TSRs 
installed in the system — it includes two copies of the interrupt vector table, and 
one data area which shows what interrupt vectors were taken over by each TSR. 
This information is used by DISABLE to deactivate and reactivate TSRs without 
removing them from memory. 


DISABLE 


Using DISABLE, you can disable and reenable specified memory resident 
programs without removing them from memory. Its function is analogous to that 
performed by REFEREE from Persoft, although DISABLE has neither a fancy 
user interface nor an option to work from within other programs. DISABLE can 
allow conflicting TSRs to coexist. 

In order to use DISABLE, you must install WATCH.COM as the first mem- 
ory resident program in your system. WATCH keeps the detailed information 
about each memory resident program that DISABLE uses to later control them. 

Like the other TSR Utilities, DISABLE is operated from the command line. 
You specify a single TSR by its name (if you are running DOS 3.x) or by its 
address as determined from a MAPMEM report. If you specify an address, 
immediately precede the address with a dollar sign ““$” and specify the address 
in hexadecimal. 

The name specified for a TSR is the one reported by MAPMEM in the 
“owner” column. If the owner column reports ‘‘N/A’, then you must instead 
specify the address from the ‘‘PSP”’ column. 

DISABLE accepts the following command line syntax: 


DISABLE TSRname or $PSPaddress [Options] 
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Options may be preceded by either / or -. Valid options are as follows: 


/A  reActivate the specified TSR. 
/? Write a brief help screen. 


If no option is specified, DISABLE will disable the named TSR. 


Examples 

DISABLE SK {disables SideKick} 

DISABLE SK /A {reenables SideKick} 

DISABLE $2F2E {disables the TSR at address 2F2E} 


MAPMEM will indicate disabled TSRs by displaying the word ‘‘disabled’”’ 
in the interrupt vector column of the report. 


RAMFREE 


RAMFREE.COM supplies a fast way to determine the amount of free RAM 
without going through CHKDSK. Just type RAMFREE and it will quickly 
report the free bytes of RAM. 


Author/Source Kim Kokkonen, TurboPower Software, 3109 Scotts Valley 
Drive #122, Scotts Valley, CA 95066. 

To quote the author, ‘These programs have been released to the public 
domain for personal, non-commercial use only. You may use them yourself, give 
them to your friends or co-workers, or distribute them for a cost-based fee as part 
of a user’s group or bulletin board service. If you wish to distribute these pro- 
grams as part of a commercial package, please contact us for a license agree- 
ment. We ask for no donation for this set of programs. If for some reason you 
want the latest version or need support, we will ask for $10 to cover the cost and 
time of shipping a new disk to you.” 
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ULTRA-UTILITIES 


Purpose Comprehensive collection of disk and file maintenance utilities. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features The Ultra-Utilities are a powerful collection of pro- 
grams that will allow you complete access to the power of your IBM-PC’s disk 
drive. Ultra-Zap will allow you to display and modify sectors of any length or 
name (such as those used in copy-protected software). It can be used in conjunc- 
tion with Ultra-Format to create your own copy-protected diskettes. Ultra-file 
provides several file utility programs as noted below. This shareware package 
provides formidable competition in features and price to the Norton Utilities™. 
A summary of the program features is listed below: 


Ultra-Zap 


Display/Modify Disk Sectors 
Display/Modify File Sectors 
Copy Disk Sectors 

Fill Disk Sectors 

Search for Bytes in Disk Sectors 
Search for Bytes in File Sectors 
Modify Sector Fill Byte 

Modify Display Radix 
Interrogate Disk Sectors 

Toggle Menu Alert Tone 
Display/Modify Disk Parameters 
Display/Modify Non-Standard Sectors 


Ultra-Format 


Format a Standard Track 

Re-format a Standard Track without Erasing Old Data 
Format a Non-standard (Copy-Protected) Tract 
Display/Modify Disk Parameter Table 

Modify Display Radix 


Ultra-File 


Display File’s Directory Information 
Assign or Remove System Status 
Assign or Remove Hidden Status 
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Display List of Sectors Allocated to File 
Build a File From Scratch 

Attempt to Restore an Erased File 
Produce a Map of Diskette 

Selectively Purge Files 


The full documentation for the Ultra-Utilities is extensive and fills 75K on 
the distribution diskette. Therefore, this information is not reproduced here. 
Please refer to the diskette documentation regarding the author’s requirements 
for distribution. The Ultra-Utilities is a shareware program for which the author 
suggests a contribution of $30. 


Author/Source The FreSoft Company, P.O. Box 27608, St. Louis, MO 
63146. 
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UNDEL.COM 


Purpose _ Restores accidentally-deleted files on floppy disks. 
Hardware No special requirement. 
Software DOS 2.0 or later, double-sided disks only. 


Description/Features If you have ever accidentally deleted a file, this pro- 
gram is for you! UNDEL.COM will restore most deleted files, provided the file 
has not been written over by another file. Therefore, you should NOT write any 
files to the involved disk after deleting the file. Otherwise, you may inadvertently 
re-use some of the disk space you might want to recover. To use the program, 


type 
UNDEL [d: ]filename[.ext] 


For ASCII files, you may use a /A switch to confirm each cluster before it is 
appended to the file being restored. You may run CHKDSK for confirmation 
after attempting to restore the file. 


Example 
UNDEL A:WORD.COM 
Author/Source Steven Holzner, PC Magazine, April 2, 1985, p. 255. 
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WRTE.COM and WRTP.COM 


Purpose Write-protects or unprotects a file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features WRTP.COM and WRTE.COM are two files which set 
and reset, respectively, the read-only bit on a file. This allows a file to be read 
(e.g. with TYPE or DIR), but won’t allow it to be written (e.g. with DELETE or 
when updating). They are quite useful for keeping files from disappearing inad- 
vertently. 


Examples 


WRIP filename to write-protect (make it read-only) 
or 
WRITE filename __ to make it writeable. 


Path names are legal; ambiguous file names are not (e.g. *.com). 


Author/Source Kent Quirk, (617) 438-2569 
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ZIP.EXE 


Purpose DOS shell, file manager, and communications in one set of compre- 
hensive utilities. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features The ZIP program is an integrated file handling utility 
package, able to do all of the following: 


Directory Functions 


1) Display an alphanumerically sorted directory list, showing ALL files, includ- 
ing hidden, read-only, system files. 

2) Read & set file attributes to hide/unhide files, etc. 

3) Copy/print/delete multiple files, including subdirectories. 

4) Rename files, including subdirectories. 

5) Wildcard selection for directory listing. 

6) Provides both Drive and Directory sizing information. 

7) Direct jump to a directory (similar to CD command in DOS). 


Edit/View Functions 


1) View standard ASCII text files and WordStar files. 
2) Edit text files, with limited screen editing capabilities. 
3) Display Hexadecimal contents (dump) of files. 


File Management Functions 


1) Squeeze/unsqueeze files. 

2) Library functions: list libraries, extract members, add members to libraries; 
create libraries. 

3) Build, list & unpack ARC files. 


Program Execution Functions 


1) Ability to execute files (BAT, .COM, .EXE) directly from directory display. 

2) Ability to run other programs or DOS functions from ZIP, without leaving 
ZIP. 

3) Ability to substitute your own commands (called ‘‘alternate commands’’) for 
ZIP’s own. 
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Telecommunications 


1) 300/1200/2400 BPS telecommunications. 
2) Send & receive text files, either in ordinary ASCII or via Xmodem. 
3) Run ZIP functions and your own commands, without disconnecting. 


Archive Functions 


1) Mark multiple files and assemble into an ARC file. 
2) List, Delete, Extract, Add single and multiple files. 
3) Verify (test) the integrity of an .ARC file. 


The ZIP files as distributed fill 200K, with 105K devoted to documentation. 
Due to the extensive documentation available with the program, this information 
is not reproduced here. 

The ZIP package performs many of the functions of the public domain 
DS.EXE program, which is also described in this book, with the addition of 
communication and file archive/compression capability. 


Author/Source (©) 1985,1986 by Edward V. Dong, 12205 Alexandria Place, 
Chino, California 91710. A shareware contribution of $40 is suggested from sat- 
isfied users. 
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COMMERCIAL FILE MANAGEMENT UTILITIES 


FILE FACILITY 

IBM Personally Developed Software 
P.O. Box 3280 

Wallingford, CT 06494 


File Facility is a path utility which helps DOS and your application programs 
navigate subdirectories. It is a small (2K) RAM-resident program that extends 
the function of the PATH command to include program overlays and help files, in 
addition to .COM, .EXE, and .BAT files. File Facility searches the current 
PATH for all open-file calls. The PATHs to be searched can be readily changed 
by issuing new PATH commands from batch files as you move between applica- 
tions. The program also makes use of environment variables in PATH com- 
mands, and can have two paths active simultaneously. 

As with all path-extending programs, files can be written to unexpected path- 
ways if you are not careful. This could result in creating files in the wrong direc- 
tory or overwriting files thought to be safe. 


MACE UTILITIES 
Paul Mace Software 
123 N. First St. 

Ashland, OR 97520 


The Mace Utilities perform many of the same functions and compete com- 
mercially with The Norton Utilities. Both packages will undelete files. Although 
the Mace Utilities lack the helpful hard disk maintenance programs in the Norton 
package, they include a hard disk file defragmenting program to improve per- 
formance, better routines for patching together files from damaged disks, 
streamlined PATH searches, and unformatting of an accidentally formatted disk. 
Although these utilities are not designed to be user-friendly, they will make a 
useful addition to anyone’s software library. 


NORTON UTILITIES 

Peter Norton Computing, Inc. 
2210 Wilshire Blvd, #186 
Santa Monica, CA 90403 


The Norton Utilities are useful in file management and data recovery. These 
include an Unerase program similar to UNDEL.COM, a public domain program 
described in this book. It also supplies more sophisticated data recovery utilities 
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which allow the user to determine whether a certain cluster on disk will be 
included in a recovered file, capability to unerase a subdirectory, a program to 
determine whether all disk files are readable, search for text functions, and capa- 
bility to sort subdirectories. One may change file attributes, a function provided 
by the freeware program DS.EXE (also described in this book). The Norton Util- 
ities provide several other useful file management utilities and should be strongly 
considered as an addition to any PC user’s software library. 


PC TOOLS 

Central Point Software, Inc. 

9700 SW Capitol Highway, Suite 100 
Portland, Oregon 97219-9978 


PC TOOLS is a collection of file management utilities including directory 
display and sorting, file copy and compare, search for text or files, rename/ 
delete/undelete/verify files, map disk sectors, print files, and view/edit files. All 
of these utilities are available in the form of separate public domain programs as 
noted in this book, but PC TOOLS provides quick access to these very useful 
functions. 


dir + 

Bourbaki, Inc. 
P.O. Box 2867 
Boise, Idaho 83701 


ldir+ is an excellent file management and DOS menu utility. The program 
provides essentially the same functions as the freeware DS.EXE program found 
in this book. The advantages of ldir+ over DS.EXE include more extensive on- 
line HELP screens, password security, a screen-saver feature, and the ability to 
run as a memory resident program. The user-interface for both programs is 
excellent and a matter of preference. 


XTREE 

Executive Systems, Inc. 

15300 Ventura Oaks Blvd., Suite 305 
Sherman Oaks, CA 91403 


XTREE is another excellent file management and DOS menu utility. It pro- 
vides essentially all the same features as DS.EXE and has the advantage of more 
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extensive on-line HELP. The user-interface for both programs is excellent and a 
matter of preference. 


REFEREE 

Persoft, Inc. 

465 Science Dr. 
Madison, WI 53791 


Like the public domain TSR utilities, Referee will allow you to peel away 
layers of memory resident software. In addition, Referee allows you to disable or 
enable memory resident programs at will, alone or in combination with other 
TSR programs. 

Referee requires 22K, far more memory than the public domain utilities. A 
pop-up menu to replace the command driven mode requires another 15K. Unlike 
the TSR Utilities, you don’t have to form the layers between programs; this is 
done automatically by Refwatch. You may unload programs by selecting their 
names from a menu. If the program you select has TSR programs loaded after it, 
these are also automatically deleted. This will close memory gaps and avoid 
unpredictable results. 

Referee can also deactivate or reactivate any program. This is useful when a 
specific TSR program conflicts with a specific application program. When you 
want to use this application, simply disable the conflicting TSR and reactivate it 
after leaving the application program. This process can be completely auto- 
mated. 
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Keyboard and Screen 
Enhancing Utilities 


KEYBOARD and screen enhancing programs, including utilities that refine the 
screen cursor, allow you to set display colors, use a Hercules graphics card to run 
Color Graphics Card applications, and beef-up the type-ahead buffer. These util- 
ities will improve your efficiency and decrease your frustration in using the key- 
board and screen. - 

Keyboard Enhancers, or “Macro programs,” are RAM-resident utilities. A 
macro is a string of keystrokes stored in memory so that it can be reproduced by 
typing a special combination of keys. Typing Alt-S for instance might produce 
“Thank you for submitting your resume and job proposal, but we are unfortu- 
nately overstaffed at present.” Typing Ctrl-M might change the margins and font 
on your word processor. 
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ALTREADO.COM 


Purpose Reassigns Alt-Function keys. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _ALTREADO reassigns any of the ten Alt-function key 
combinations to a string of characters of your choice. Perhaps the most useful 
application is to use function key reassignments to quickly type commonly-used 
commands. Although it is limited to assigning function keys only, it is easier to 
use than the full-featured keyboard extenders such as SUPERKEY, KEY- 
WORKS, or NEWKEY. The syntax is 


ALTREADO [key] [string] 


key = ALTF1, ALTF2, ALTF3, ALTF4, ALTF5, ALTF6, ALTF7, ALTF8, 
ALTF9, OR ALTF10 
string = any string to which DOS can react. 


The function key reassignment will be active until a reboot, or another 
ALTREADO command reassigns a particular function key. 


Example 

ALTREADO ALTF10 DIR B: 

would issue the command DIR B: when Alt-F10 is pressed. 
ALTREADO ALTF8 COPY A:*.* B: 

would issue the command copy a:*.* b: when Alt-F8 is pressed. 


Author/Source Garry Vass 
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BACKSCRL.COM 


Purpose Screen display memory buffer. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features Back Scroll! is a bi-directional scrolling utility. Once 
activated, Back Scroll! will buffer the screen scrolling so that the user may recall, 
with a few simple keystrokes, data that has previously been scrolled off the 
screen. The user may either scroll by line or by page through the Back Scroll! 
buffer. In addition, Back Scroll! printer commands allow the user to select and 
print any data that is currently in the buffer. 

When Back Scroll! is loaded, it becomes an extension to DOS and from then 
on will be transparent to the user and most programs. The activation of Back 
Scroll!, once loaded, can be done at any time without any danger to the current 
operation. When entering and exiting Back Scroll!, the current display screen 
will be saved and restored so that the user may continue without any interference. 

The installation of Back Scroll! is simple in that the program only needs to 
be copied onto a working disk. Once installed the program is called as follows: 


BACKSCR, parm] ,parm2 


where parm] may be substituted with a number between 1 and 28 to specify the 
number of screen pages. Remember, Back Scroll! will take up between 8000 and 
58000 bytes of system memory depending on the amount chosen. Again, the 
default is set at 4 screen pages or about 14700 bytes of memory. 

parm2 may be substituted with a number between 1 and 25 and will specify 
the numbers of lines Back Scroll! will page up and down through its buffer. The 
default is set at 25 lines or a full screen, but you may wish to change it. 


Operations The operation of Back Scroll! is easy and can be done in a few 
simple steps. 

First, Back Scroll! must be called with the proper parameters. This can be 
done by entering this command at the DOS prompt: 


BACKSCRL, parm], parm2 


and depressing the return key. 

If no parameters are given, Back Scroll! will create a 4 screen buffer with a 
25 line page up and page down rate. The size of Back Scroll! will be about 14700 
bytes long but may be changed as noted in the installation section by simply spec- 
ifying the parameters. Once Back Scroll! is loaded, you will be returned to the 
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DOS prompt. Except for a reduction in system memory, you may then continue 
using your computer normally. 

Second, now that Back Scroll! is an extension of DOS, it may be called up 
while in any program. The commands for doing this follow: 

Control + Space Bar. These two keys are used to toggle into Back Scroll!. 
To avoid interfering with the current program, the keyboard will respond nor- 
mally until these keys are pressed. Once in Back Scroll!, the current operation is 
suspended and the display screen is saved. 

Control + Return. Pressing these two keys simultaneously will ‘‘take a pic- 
ture” of the current screen. This can be done at any time and will move the entire 
screen into the buffer and then return the user to the current task. 

The following keys must be used after the “Control + Space Bar’’ sequence: 

Home. This key will move the cursor up one line in the buffer. If the cursor 
is at the top of the screen, the screen will be scrolled down one row and the top 
line displayed on the screen from the buffer. 

End. This is the opposite of the above key. The cursor is moved down or the 
screen is scrolled up, then a line from the buffer is displayed. 

Cursor Up. This is used to scroll up the buffer. The screen will be scrolled 
while leaving the cursor in its current position on the screen. 

Cursor down. Same as the above command except that the buffer is scrolled 
down. 

Page Up. This key will allow the buffer to be scrolled up at between 1] and 25 
lines at a time. The actual number of lines is selected when Back Scroll! is 
loaded. 

Page Down. Same as the above key except that the buffer is “paged’’ down 
instead. 

Minus (—). This is the grey minus key on the right side of the keyboard. 
After positioning the cursor, pressing this key will mark the beginning of the 
buffer to be printed. 

Plus (+). This is the grey plus key on the right side of the keyboard. Press- 
ing this key marks the end of the buffer to be printed at the current cursor posi- 
tion. 

PrtSc. This will cause the marked buffer to be printed to line printer 1. This 
command can be aborted at any time by hitting any key. 

Space Bar or Return. Either of these keys will exit Back Scroll!. The cur- 
rently saved screen is restored and the suspended operation is continued. Once 
out of Back Scroll!, it can be easily called up at anytime again by using the Ctrl- 
Space Bar sequence. 

While using Back Scroll!, a number will appear in the upper right corner of 
the screen. This is a counter and it starts from the last line that was saved into the 
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buffer. This number will change as the user moves around the buffer and serves 
as a guide to the current location. 


Author/Source Karlton & Kendrick Kam, (©) 1983 by The Kampro Group. 
A shareware contribution of $20 is requested from satisfied users. The Kampro 
Group, Post Office Box 90654, Honolulu, Hawaii 96835. 
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COLOR.COM 


Purpose Change CGA foreground and background colors. 
Hardware Requires color graphics adapter. 
Software DOS 2.0 or later. 


Description/Features _COLOR.COM allows you to change the standard white 
on black attributes of DOS to any color scheme. Foreground, background, and 
border colors may be specified. The command syntax is: 


COLOR / foreground [background] [border] 


where background and border are optional parameters. The colors are specified 
using these codes: 


0 Black 8 Grey 

1 Blue 9 Light Blue 

2 Green A Light Green 

3 Cyan B Light Cyan 

4 Red C Light Red 

5 Magenta D Light Magenta 
6 Brown E Yellow 

7 White F Bright White 


Please note that all color combinations are not legible, blinking attributes cannot 
be specified, and the border color is not refreshed after DOS CLS. In order for 
the reset feature and the replacement feature to work properly, COLOR.COM 
should be the last program run that alters the video interrupt. 


Example COLOR /4E6 is Red on Yellow with a Brown border. 


Author/Source George Bohannan, enhanced by Tim Mason. 
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CTRLALT.COM 


Purpose Collection of DOS-resident utilities. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features ©CTRLALT is a collection of resident utilities requiring 
7K of RAM. Its features include the following: 

Two monitor support. Copy the active monitor to your inactive monitor on a 
two monitor system (even inside a running program), making your second moni- 
tor a useful scratch pad; other dual monitor support included. 

Popup tables. One-screen tables of ASCII codes, color attributes, ANSI 
color codes and keyboard scan codes. 

Entry of non-keyboard characters. A logical and convenient way of entering 
the IBM graphics drawing characters. Any character can be picked off the resi- 
dent ASCII table. 

Cut and Paste. Resident cut and paste facilities; with one keystroke, you can 
enter a mode which allows you to mark a box (on either screen, if you have two) 
which you can save in a buffer and later insert in any program. You can print part 
or all of your screen (or screens on a dual monitor system). 

Resident printer codes. If you have an IBM graphics compatible printer, you 
can send a variety of control codes to it at any time. 

Emergency exit. A way of recovering from situations where your system 
crashes due to some program getting into a loop or dead end. 


Command Summary for CTRLALT 


‘@A ASCII table; see below *@U NOT USED 

‘@B_ Backspace mode A@V Vanilla 

‘@C Copy screen “@W NOT USED 

4@D NOT USED *@X NOT USED 

A@E_ Enter small buffer A@Y NOT USED 

4@F NOT USED \@Z Zilch mode 

‘@G NOT USED ‘@<F9> Emergency Exit 

‘@H_ Hex table; see below ‘@<Enter> Marking Mode; see below 
“@I Insert large buffer @<=/+> Fast Insert Mode 

‘@J NOT USED 4@<-/_> Slow Insert Mode 

‘@K Kill other screen ‘@7 — left; + up mode 
,@L NOT USED “@8 normal alt Grey +/- 
‘@M NOT USED A@9 — right; + down mode 
A@N_aNsi table @0 @Keypad std. mode 
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‘@O tables on Other sern 

A@P Print control mode; see below 
‘@Q_ Quit buffer insert 

‘@R_ carriage Return mode 

‘@S Switch monitors 

A@T_ arTtribute table 


Subcommands 


4@A,°*@H subcommands: E(nter), P(rint), B(uffer), Arrows, <Esc> 
4@P subcommands: <Up>, <Down>, <PgUp>, <PgDn>, S(witch), 
P(rint), A(ll), various escape codes to printer 

4@<Enter> subcommands: Arrows, <Enter> or <Ins> to tack down 
arrows, <PgUp>, <PgDn>, <Grey +>, 
<Grey -—>, S(witch), C(opy), P(rint), (c) 
U(t) = <Enter> = <Ins> 

‘@1—6: @numeric keypad, @<Grey + >, @<Grey -> 


This program is provided with a large documentation file (100k) which is not 
reproduced here, but is available on the software diskette. 


Author/Source —_ Barry Simon and Richard Wilson, 253-37 Caltech, Pasadena, 
CA 91125. 
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CUTPASTE.COM 


Purpose Captures and cuts anything appearing on the screen and pastes later 
to another application. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features CUT-PASTE is a memory resident utility, designed for 
installation at bootup. It is quite small—using less than 6K of memory. Using 
CutPaste, anything which appears on the screen may be “‘cut”’ out and saved for 
later “pasting” into an application. CutPaste is installed by executing the CUT- 
PASTE .COM file from either the command line or the AUTOEXEC.BAT file. 

Once installed, CutPaste may be brought up at any time by entering Alt-F9. 
The cursor will move to its position on the screen when CutPaste was last exited. 
Use the arrow keys to move the cursor to any place on the screen. Place the cur- 
sor at one corner of the area to be cut out and depress the End key. Notice that the 
character underneath the cursor turns to inverse video. Now move the cursor to 
the opposite corner of the area to be cut out. As the cursor is moved the entire 
area will appear in inverse video. Depress the End key one more time and the 
screen returns to normal. You are now “out” of CutPaste. To paste the cut area 
into the application, press Ctrl-F9. The box cut previously will be “typed” into 
the application, as if reentered from the keyboard, starting at the upper left hand 
corner and proceeding to the lower right hand corner. If you wish to exit CutPaste 
without cutting anything, reenter the Alt-F9 key. 

CutPaste will add block move capabilities to any word processor (or other 
program) which uses BIOS interrupt 16 for keyboard input (that’s just about ev- 
erything except XYWRITE). CutPaste has been tested with many other installa- 
bles, notably SideKick and the MicroSoft and Mouse Systems mouse drivers. 
CutPaste only works in alphanumeric mode. CutPaste is designed to work in 
combination with BACKSCRL. Thus, if something of importance has scrolled 
off of the screen, you may scroll the screen back (using BACKSCRL) until the 
area of importance reappears, open up CutPaste, cut it out, and then paste into 
your application. In order for this to work, the order of installation is CUT- 
PASTE and then BACKSCRL. 


Author/Source Stephen R. Davis, Gerry Boyd, Larry Weiss, Route 5 Box 
107K, Greenville, Tx 75401 214-454-2426 
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HGCIBM.COM 


Purpose Emulates an IBM Color Graphics Adapter on a Hercules Graphics 
Adapter. 


Hardware Hercules Graphics Adapter as the ONLY video adapter on your 
system. If this is not the case, do not attempt to run this program. 


Software DOS 2.0 or later. 


Description/Features The purpose of this program is to provide owners of 
Hercules Graphics Cards a means to run software written for the IBM Color 
Graphics Adapter in hi-res (200 x 640) black and white mode. The current ver- 
sion will NOT support the 200 x 320 mode. 

This program will not damage your display, but ill-behaved application soft- 
ware certainly can. Programs which attempt to bypass the BIOS system to set the 
CRT operating parameters will cause severe problems. Fortunately since 200 x 
640 is a standard mode, most software uses BIOS even if they later write to 
screen RAM directly. HGCIBM will intercept the BIOS call for this mode and 
program the controller correctly. Writing directly to screen RAM is permitted 
and the emulator will still work properly. A list of tested software appears below. 
When trying a program for the first time, watch your display carefully for signs 
of gross distortion or shrinking when the program sets graphics mode. If this 
occurs, reboot or turn off your computer IMMEDIATELY. The display should 
return to normal quickly when you reboot. 

HGCIBM installs itself between two BIOS interrupts. Other software using 
the same two interrupts will continue to be called after HGCIBM has done its 
work. The two interrupts used in this way are hex 10 (BIOS video) and hex 8 
(timer). The latter is used only while in graphics mode. HGCIBM will fail to 
function properly if it is not given control during the above interrupts. Load it 
last if you have other resident software that may interfere with these interrupts. 
HGCIBM needs to be loaded only once each time the computer is started because 
it attaches itself to BIOS and stays in memory until reboot, or it is commanded to 
un-install. The memory usage is only 1K. 


Installation 


Full Mode. The Emulator ‘full’? mode provides maximum compatibility 
with programs expecting to use the IBM Color Graphics Adapter. When the emu- 
lator is in this mode, the text buffer is at segment B800 and the equipment flag is 
set to indicate that a CGA card is present. Alas, you can’t fool all the programs 
all the time. Some of the smart ones read the equipment flag and then try to 
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manipulate the CRT controller directly in order to provide faster screen output. 
Naturally they try to do this at the CGA port addresses (which don’t exist) and 
will hang the system. A reboot will cure the problem and you should then 
remember to either uninstall the emulator before running these programs, or try 
it in HALF mode as described below. One example of a program which is 
incompatible with FULL mode is WordStar Version 3.3. It will work fine how- 
ever with HALF mode. An example of programs requiring the FULL mode to 
function is anything compiled under Microsoft Quickbasic (the accompanying 
HGCTEST program is compiled this way). 

Half Mode. The Emulator “‘half’’ mode sets the equipment flag to indicate 
color graphics only while in graphics mode. During text mode, the system regis- 
ters and equipment flag are set just as if the emulator were not installed. This 
mode provides maximum compatibility with programs which expect to use the 
monochrome adapter, and will provide graphics with many of the CGA programs 
which do not try to check installed equipment before they run. Examples of pro- 
grams which will run in HALF mode are the Microsoft Basic Interpreter, vand 
Energraphics. 

Uninstall. You may un-install the emulator with the /u switch, but memory 
may become segmented if you have loaded another resident program “behind” 
HGCIBM. The system will be left in the same condition it was in before the 
installation (i.e. monochrome display). 

Using the command line: 


HGCIBM /H_ - installs in (or changes to) HALF mode 
HGCIBM /F -_ installs in (or changes to) FULL mode 
HGCIBM /U - UN-INSTALLS the emulator 


These commands may be issued from a batch file if desired. To change 
modes after installation, just enter the command as above. HGCIBM always 
checks to see if it is already installed and will process the command correctly. 

The programs listed below have been tested with IBMHGC: 


Energraphics Version 1 (FULL or HALF mode) 

Printmaster Version 1 (FULL or HALF mode) 

Smartwork Circuit Board Program through version 1 Rev 9 
(FULL or HALF mode) 

Hires graphics programs compiled with IBM Basic Compiler Ver 1.00 
(FULL or HALF mode) 

Hires graphics programs compiled with Microsoft Quickbasic 
(FULL mode only) 

Microsoft Basic Interpreter Version 2.00 (FULL or HALF mode) 
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The only program known not to work in FULL mode is WordStar 3.3. It will run 
properly in HALF mode. There might be other programs which do not work in 
FULL mode which have simply not been tested. 


Author/Source (©) Copyright 1986, Athena Digital, Gary Batson, 145 
Green Hills Rd., Athens, Ga. 30605. Author requests a $6 or $9 contribution 
from satisfied users. Due to the authors request, the program is not included with 
this book. Copies may be obtained from many electronic BBS services or share- 
ware program services. 


38 


Keyboard and Screen Enhancing Utilities 


KBFIX2.COM 


Purpose Keyboard enhancing utilities including cursor speed and refinement, 
buffer enlargement, and visual/aural indicators for the toggle keys. 


Hardware No special requirement. Designed to be PC/XT/AT compatible. 
Software DOS 2.0 or later. 


Description/Features KBFIX2.COM is a memory resident program which 
contains several keyboard-enhancing utilities. Most of these enhancements can 
be found in other public-domain or commercial programs, but they tend to be 
grouped together with other features which you might or might not want, and 
which often can’t be shut off. KBFIX2 was written to be as compatible as possi- 
ble with other programs, and as flexible as possible in terms of options; all its 
features can be enabled or disabled at any time from the DOS command line. 


Using the Program KBFIX2 can be invoked from the command line or from 
within a batch file. The first time the program is invoked it loads itself (2.5K) 
into memory; it will then remain resident until the system is rebooted, or until it 
is removed from memory with the /K option. The current configuration of 
KBFIX2 is selected by means of the command line options outlined below, any 
or all of which can be changed at any time. 

Options can be entered separately or in groups. Each option or group must 
be preceded by ‘-’ or ‘/’, and must be separated from other groups by at least one 
space or tab. There must be no spaces within groups. To enable or disable an 
‘on/off option, follow the letter(s) with 1 or 0. KBFIX2 options are listed below: 

KB. (use extended Keyboard Buffer; Default - Enabled). Enabling this 
option activates the 127-character keyboard buffer. It also allows KBFIX2 to 
check for the special characters Ctrl-C, Ctrl-S, and Ctrl-P, which are normally 
only recognized by DOS if they appear at the beginning of the keyboard buffer. If 
any one of these characters is typed while KBFIX2’s buffer is active, the buffer 
will be cleared, and the character typed will be placed at its head. 

KT. (adjust Typematic action of Keys; Default - Disabled.) Enabling this 
option allows adjusting the speed of typematic key repeating; disabling it returns 
typematic action to normal. The options that start with ‘KT’, below, will retain 
their settings even if typematic is disabled, so it’s not necessary to reenter them if 
it becomes necessary to shut off typematic temporarily. 

KTD. (Ticks to Delay before starting (0-99); Default - 6.) Sets the number of 
timer ticks which will occur before typematic repeating begins. Timer ticks hap- 
pen approximately once every !/isth second, so if this number is larger than 
about 9, the only effect it will have is a speedup of the typematic rate of an 
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already repeating key, because normal typematic action seems to start (on an 
IBM-PC, at least) about one-half second after the key is first pressed. 

KTR. (Ticks between key Repeats (0-99); Default - 0.) Sets the number of 
timer ticks which will occur between repeats of the currently-pressed key. Setting 
this option to zero results in 18 repeats per second. These repeats are in addition 
to the normal typematic repeats produced by the keyboard, so the effective rate of 
repeating will be considerably higher than the setting of this option would other- 
wise indicate. 

KTN. (Num. chars. inserted each repeat (1-10); Default - 7.) Determines 
how many copies of the currently repeating keycode to place into the keyboard 
buffer each time the key is repeated. Fine tuning of the effective typematic rate is 
possible by experimenting with various combinations of this setting and the KTR 
setting above. 

F. (Fix caps-lock reverse character shift; Default - Always.) Tells KBFIX2 
whether or not to fix the annoying ‘reverse-shift’ which occurs when caps-lock is 
on and a shift key is pressed. When caps-lock is on, only capital letters will 
appear on the screen. Following the ‘F’ with ‘1’ causes caps-lock to act more like 
caps-lock on a typewriter: The first time a shift key is pressed along with any 
alphabetic character when caps-lock is on, the alphabetic character will be capi- 
talized. Caps-lock will then be turned off. 

D. (Display state of locking keys; Default - Enabled.) Enabling this option 
results in an on-screen display of the state of the caps-lock, num-lock, and scroll- 
lock toggles. 

C. (Starting Column for display (0-77); Default - 77.) Sets the starting 
screen column for the 3-character flag display. 

R. (Row for display (0-24); Default - 0.) Sets the row for the flag display. If 
the row setting is other than 0, the flags will ‘clone’ themselves whenever the 
screen is scrolled. 

W. (Wait for Retrace on color display; Default - Enabled.) Disable this 
option if you have a color card (EGA, etc.) that doesn’t produce ‘snow’ on the 
monitor. Those using a standard IBM color graphics board should leave the 
option enabled. 

T. (Use Timer interrupt to update display; Default - Disabled.) Enabling this 
option tells KBFIX2 to update the flag display 18 times per second by using the 
timer interrupt; disabling it means the flags will only be updated whenever a key 
is pressed. Use of this feature allows the flags to be seen in programs which 
would otherwise overwrite them between key presses, but it also slows down the 
entire system slightly due to the overhead involved in writing to the screen. The 


slow-down seems to be less than one percent, though, even when using a color 
monitor. This option has no effect unless the D option above is also enabled. 
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B. (Beep when locking keys are toggled; Default - Enabled.) Determines 
whether the bell will sound whenever the state of one of the toggling keys 
changes. If this option is enabled, the machine will beep from low to high when- 
ever a toggle changes from off to on, and from high to low whenever a toggle 
changes from on to off. You can follow the *B’ with a ratio (n:n) to control the 
pitch of the beeps. This is useful when running KBFIX2 on faster machines like 
the AT, etc. Entering B2:3, for example, results in a pitch which is 2/3 of normal, 
which should sound about right on an AT. Numbers from 1 to 9 can be used; if 
the second value is missing, it is assumed to be ‘1’. 

S. (Scroll lock pause control; Default - Disabled.) Enabling this option will 
make KBFIX2 enter a loop whenever the scroll-lock key is pressed. The loop 
will cause screen output, and any other non-interrupt-driven activity, to pause 
until the next time scroll-lock is pressed (either by itself, or at the same time as 
the shift key). The scroll-lock key can always be used normally (to shift the 
scroll-state) by holding a shift key (Right/Left Shift or Alt) down at the same 
time. If the D option is enabled, a blinking S will be displayed while the pause is 
in effect. 

V. (Verbose display of current settings; Default - Enabled.) Disabling this 
option prevents KBFIX2 from presenting its normal display of current settings. 
To have any effect, this option must be specified each time KBFIX2 is invoked. 

K. (Kill KBFIX2, remove from memory.) Entering /K on the command line 
causes KBFIX2 to remove itself from memory if possible. This command should 
be used carefully because it can result in memory ‘holes’ if KBFIX2 isn’t the last 
resident program installed. If KBFIX2’s interrupt vectors have been modified by 
another program, this command will fail, because removing the program from 
memory in such a situation is almost certain to lead to a system crash. 


Example 
KBFIX2 /FO /KT1 /KTD5 /D1 /T1 /C50 /RO /BO /VO 


disables the caps-lock fix, enables typematic adjustment, sets the typematic delay 
(before starting to repeat a pressed key) to 5 ticks (°/isths of a second), enables 
the key-state display and timer update, sets the display column and row to 50/0, 
disables toggle beeps, and tells KBFIX2 not to display its current settings. 

To avoid having to remember all this, enter your normal parameters in 
AUTOEXEC.BAT or in some other convenient batch file. 


Author/Source Skip Gilbrech, 90 Lexington Ave., #10-G, New York, NY 
10016. 
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KEYBUF.COM 


Purpose Expands the keyboard buffer from 12 to 128. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features KEYBUF is a handy utility which eliminates the 
annoying problem of running out of type-ahead space while the currently execut- 
ing program is not accepting keyboard input. Once executed, KEYBUF provides 
128 characters of type-ahead buffer space instead of the 12 characters provided 
by DOS. The increased productivity afforded by this is often surprising. This 
program is a good candidate for your AUTOEXEC.BAT file. 


Author/Source Unknown. 
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KEYCLICK.COM 


Purpose Program to cause “click” with each key depressed. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features KEYCLICK is a resident utility which causes the 
speaker to produce a “‘click” with each depression of a key, and when keys are 
being held down for repeats. Touch typists may prefer this form of feedback, 
especially on some of the poor-response keyboards. 


Author/Source Unknown. 
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LIST.COM 


Purpose Enhanced TYPE command to scan files on the screen. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features LIST is a power-packed utility that can scan forward, 
backward, or sideways through files. The user may scan by scrolling single lines 
or by the page. These features are similar to the BROWSE.COM program found 
in this chapter. Other functions include searching for text, filtering control char- 
acters out of text files to make them readable, printing all or part of a file, split- 
screen comparisons of two text files, and toggling between 25 and 43 lines on an 
EGA. 

Due to restrictions by the program author, the program documentation and 
program could not be included with this book. You may obtain a copy of these, 
however, on many electronic bulletin board systems or by writing the author with 
your shareware contribution. 


Author/Source Vernon D. Buerg, 456 Lakeshire Drive, Daly City, CA 
94015. A shareware contribution of $15 is requested. 
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NEWKEY.EXE. 


Purpose Keyboard macro program. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _NEWKEY is a shareware keyboard enhancer which 
simplifies the entry of common keystroke sequences by allowing these sequences 
to be assigned to any key desired. Once assigned to a particular key, whenever 
that key is struck the predefined sequence of keystrokes will be substituted for the 
struck key. 

NEWKEY allows customization of software packages, ready creation of 
boiler plate passages, keyboard redefinition, and other useful features including: 


e Ability to define almost any key 

e Shorthand mode 

Fixed and variable length pauses during playback 
Nested macro playback 

Multi-character macro names 

Macro descriptions/titles 

Cut & Paste 

Extended keyboard buffer 

Ability to custom tailor NEWKEY features 
Screen saver feature 

Slow typing mode 

Saving, loading, and merging macros on disk from memory 
Display and editing of macros 


The documentation for NEWKEY is extensive and fills an 86 page manual. 
Due to the author’s requirements, I cannot reproduce the documentation or dis- 
tribute the program with this book. However, you may obtain this shareware pro- 
gram directly from the author as listed below, or from a variety of sources of 
public domain software as listed in the Appendix. 

This program is comparable with higher-priced commercial keyboard 
enhancers such as SuperKey, Prokey, and KeyWorks and is an excellent value. A 
full comparison review of these programs appears in PC Magazine, September 
29, 1987 in which NEWKEY was chosen as an “‘Editor’s Choice.” 


Author/Source ‘Frank A. Bell, FAB Software, P.O. Box 336, Wayland, MA 
01778. A contribution of $30 is requested of satisfied users and entitles you to a 
printed manual and disk containing a full, updated version of NEWKEY. 
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POWERKIT.OBJ 


Purpose Multiple keyboard enhancers in one package. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features: 
Installation. To operate POWERKIT, the file POWERKIT.OBJ must be on 
your boot disk, and the line 


DEVICE = POWERKIT.OBJ [optional instructions to POWERKIT may go here] 


must be in the CONFIG.SYS file on your boot disk. Ideally, this line should be 
the FIRST line in your CONFIG.SYS file. Your boot disk is the floppy disk you 
place in disk drive “A” when you turn the machine on, unless you have a hard 
disk drive, in which case your boot disk is the hard disk. If you do not have a file 
named CONFIG.SYS on your boot disk, transfer the CONFIG.SYS file that 
comes with this package to your boot disk at the same time you transfer 
POWERKIT.OBJ. To transfer these files, boot up, put the disk containing 
POWERKIT.OBJ and CONFIG.SYS in floppy disk drive “B,” then type: 


COPY B:POWERKIT.OBJ Enter COPY B:CONFIG.SYS Enter 


On some machines, the Enter key is labeled Return—on others a downward and 
leftward pointing, right-angled arrow. If your machine has only one floppy disk 
drive and no hard disk drive, drive “‘B” is also drive “A,” and the above proce- 
dure will involve swapping your boot disk with the POWERKIT.OBJ disk, and 
back again. 

Reboot your computer, POWERKIT will let you know if it is loaded. 

Introduction. POWERKIT is small, about 2200 bytes of it stay in memory. If 
each of POWERKIT’s tasks were to be done by separate “COM” programs, 
many thousands of bytes would be used. Almost all of POWERKIT’s operations 
may be controlled from the defining line in the CONFIG.SYS file or from the 
keyboard—even while you are inside another program. Many can be disabled, if 
your favorite utility program does the same thing better. After all, POWERKIT 
costs you very little memory. 

You will like the way POWERKIT handles your keyboard. A key, when 
pressed, starts to repeat after a waiting period whose length you set, accelerates 
smoothly to a top speed you set, and when released, ‘“‘stops on a dime.” Key- 
strokes also may be set to repeat very slowly, or to repeat not at all. 
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POWERKIT’s AutoPilot lets you teach your machine how to do a repetitive task, 
while you sit back and relax. 

If that’s not enough, add an extra large keystroke buffer and an ability to 
view what’s in it, a way to route printer output to your screen, an escape hatch 
from programs that falter, a screen blanker, a floppy disk motor shut-off, a way to 
protect your machine from prying eyes and mischievous fingers, a few other 
things, and there’s HOOK. 

HOOK is unique. HOOK will open up many of those programs that won’t let 
your ‘‘can’t live without” pop-up utilities pop up. HOOK will do other things too 
(see ‘‘Keyboard redefine,” and ‘‘Ctrl-Tab, H”’ below). 

Commands executed from the CONFIG. SYS File. Most POWERKIT param- 
eters may be set by including them on the line DEVICE =POWERKIT.OBJ in 
CONFIG.SYS, and three MUST be set from this line. BE SURE to leave a blank 
space after ‘“‘... .SYS’’, then put a forward slash, the first letter of the command, 
and the number to which you wish to set the parameter. For example, the line: 


DEVICE = POWERKIT.OBJ /b35/M15/W5/d2/f1 10/g14 


will set the keystroke buffer size to 35, the floppy disk motor to shut off after 1.5 
seconds (15 tenths), the wait before repeating a keystroke to '/2 second (5 
tenths), the display to switch off after 2 minutes (if no keys have been pressed 
during that time), the keystroke repeat speed to a maximum of 110 keystrokes per 
second, and the HOT key to Backspace (14 is the decimal scan code for Back- 
space). The commands may be entered in any order, in lower- or uppercase. 

There are 3 commands that can be given only from the DEVICE= 
POWERKIT.OBJ line in the CONFIG.SYS file: 

/M)otor off. (after 1 to 255 tenths seconds) This command has nothing to do 
with speeding up floppy disk input or output, it merely allows the computer to 
turn off the floppy disk drive motor after so many tenths of a second. This com- 
mand is included in POWERKIT to let you get back to work more quickly after a 
disk access (the keyboard sometimes won’t work while the motor is ON). Also, 
it is not always safe to remove a disk from the drive while the motor is ON (stray 
magnetic fields produced by the motor could garble the data on your disk). If you 
tell POWERKIT nothing about motor shutoff, POWERKIT will set it to one sec- 
ond. 

/B)uffer size. (15 to 255 keystrokes) If you set the buffer size to 15 key- 
strokes or less, the 15 keystroke buffer at 40h:1Eh will be used. Also, 
POWERKIT will use this buffer when POWERKIT is loaded too high in mem- 
ory. Therefore, if you wish to use a keystroke buffer larger than 15 keystrokes, 
put the DEVICE = POWERKIT.OBJ line FIRST in your CONFIG.SYS file, and 
tell POWERKIT how large a buffer you want. 
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/K)eyboard redefine. There is a type of program we’ll call a KIM, a Key- 
board Interrupt Monopolizer. If you own SIDEKICK, or a similar program, and 
you tried to call it up by pressing Ctrl-Alt (or some other HOT key) while inside 
another program, and it either wouldn’t pop up or your machine froze, that pro- 
gram you were inside was a KIM. KIM’s have other problems, too. The older 
KIM’s have no way of recognizing the larger keyboards that come with many of 
the newer PC compatibles, except for the keys corresponding to the old 83 key 
“standard PC keyboard.” This means you can’t use the separate cursor keypad 
while working within the KIM, for example. POWERKIT’s Keyboard Redefine 
and HOOK commands could help you with that problem. 

Keyboard Redefine takes two forms. First, you can put pairs of scan codes 
on the DEVICE = POWERKIT.OBJ line; a “/” then the decimal scan code you 
wish to redefine, followed by ‘‘/” plus the decimal scan code you wish it to be— 
repeating this for each key to be redefined. For example, what you see below 
makes the keyboards of TANDY 1000’s or 2000’s work just fine inside most 
KIM’s: 
1K41/72/43/75/74180/78/77/88/7 1189/4 1/90/43 

/85/78/83/74/87/28/86/83/84/70 


Obviously, you need to know something about scan codes to do this, which leads 
to the second way /K can be used. Putting /K on the DEVICE=POWER- 
KIT.OBJ line, followed by nothing at all, or followed by another POWERKIT 
command (like /k/h, for example) causes POWERKIT to help you find the scan 
codes. First, the machine will start its normal boot up procedure. When it loads 
POWERKIT, a beep will occur, and the display will read: 


Press key to be changed, ESC to quit: 


Ik 


Press a key, and its scan code (in decimal) will appear behind the /k, you will 
hear another beep, and the display will show: 


Press key to change to: 


IkKXX 


The XX above represents the scan code of the first key pressed. Press a second 
key; its scan code will appear as /kXX/YY. Another beep, and the Press key to be 
changed, ESC to quit: prompt will reappear. In this way you can tell 
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POWERKIT which keys you want redefined. For example, to get that long line of 
redefined scan codes shown above, do the following (keypad means the numeric 
keypad): 


PRESS THEN PRESS ACTION 

up arrow keypad 8 fixes up arrow key 

left arrow keypad 4 fixes left arrow key 

down arrow’ keypad 2 fixes down arrow key 
right arrow keypad 6 fixes right arrow key 
Home keypad 7 fixes Home key 

Pll up arrow makes F11 print 9 and ~ 
FI2 left arrow makes F12 print \ and 
Insert right arrow changes Insert to grey + 
Delete down arrow changes Delete to grey — 
keypad Enter ENTER fixes keypad Enter 
keypad . DELETE changes keypad . to Delete 
BREAK HOLD fixes Ctrl-Break 

ESC saves scan codes and exits 


(inside a KIM, keypad 0 will probably act like INSERT) 


In general, for any extended keyboard, you can use the first five sequences above 
for the arrow and Home keys, and in addition: 


PRESS THEN PRESS ACTION 


End keypad 1 fixes End key 
PgUp keypad 9 fixes PgUp key 
PgDn _ keypad 3 fixes PgDn key 
Insert keypad 0 fixes Insert key 
Delete keypad. fixes Delete key 
Esc exits 


POWERKIT has enough room for 15 redefined keys. After all this, the line on 
the display starting with /k will show the necessary scan codes to put on the 
DEVICE = POWERKIT.OB3J line before you next run the KIM; but there is no 
need to reboot the computer now, just write down the /k line for future reference. 
POWERKIT has saved these codes, and after you do just one more thing, you can 
load the KIM and have your keyboard work properly. That final task is to activate 
HOOK while the Caps key is turned ON. HOOK is activated by Ctrl-Tab, H. See 
page 8 for a complete discussion of HOOK. Turning on HOOK with CAPS ON 
tells POWERKIT to feed the new scan codes to the KIM. 
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Other commands that may be put on the DEVICE=POWERKIT.OBJ line 
are: 


/D)isplay off 

/W)ait before repeating 

/F)ast repeat 

/R)epeating key overshoot inhibit 
/G)et new HOT key 

/H)ook. 


Note that when defining the HOT key here, the (decimal) scan code of your des- 
ignated HOT key must be used. Note also that when HOOK is placed here, and 
you wish it to be used with /K)eyboard redefine, make sure the Caps key is ON 
while your machine is booting up. 

Commands accessed by pressing Ctrl-Tab. From here on, when two key- 
stroke designations are capitalized and connected by a hyphen (for example, Ctrl- 
Tab), read that to mean press the second key while still holding down the first 
key. What follows are descriptions of the POWERKIT commands accessed from 
the keyboard. First, the Ctrl-Tab combination must be pressed, RELEASED, 
then the indicated Command key pressed and released. If the command needs 
more input (numbers or letters), enter them when you hear a beep. Press Enter 
when finished. 

Ctrl-Tab, PrtSc (this key also labeled PRINT or Print Screen): Directs out- 
put normally destined for the printer, to the screen. This is handy when no printer 
is available and you must use a program that demands a printer be attached (when 
you are using a PC compatible laptop away from the office, for instance). It also 
lets you preview the formatting of a document without wasting a lot of time and 
paper, if you don’t have a WYSIWYG (what you see is what you get) text editor. 
Pressing Ctrl-Tab, PrtSc a second time turns off this feature. 

Ctrl-Tab, Esc. Sometimes can bring you back to the DOS prompt from a 
hung or crashed program. When Ctrl-Tab, Esc does succeed (when you have pre- 
cious unsaved data on a RAM-disk for example), POWERKIT will have earned 
its keep. 

Note: A few programs have their own escape routines. If they exist, they are 
invoked by either Ctrl-Break or Ctrl-C (usually). 

Ctrl-Tab, W. At the beep, entering a number from 1 to 255, followed by 
Enter, will set the delay before keystrokes begin to repeat to that many tenths of a 
second. Enter zero if you wish to go back to your old, sluggish keyboard. But 
then, POWERKIT tasks associated with Ctrl-Tab W, F, S, A, and R will no 
longer work. 
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Ctrl-Tab, F At the beep, entering a number from 5 to 255, followed by 
Enter, will set the maximum speed of keystroke repeats to that many repetitions 
per second, give or take 2 reps./second. The actual repetition rate will be deter- 
mined by how fast the application program can handle keystrokes (ANSI.SYS 
slows the repeat rate, for example). Enter zero and the keyboard will work like 
an old-fashioned typewriter keyboard (no auto-repeat, a more comfortable mode 
for those with disabilities). 

Note 1: Use Ctrl-Tab, S (see below) for 1 rep./sec, or slower. 

Note 2: Some repeat speeds are smoother than others. This is determined by 
the tick rate of the system clock. For most PC compatibles, 5, 10, 19, 37, 55, 74, 
92, 110 reps./sec. are the smoothest. Also, adding one or two nulls/rep. (Ctrl- 
Tab, R) smooths things out. 

Cirl-Tab, S. At the beep, entering a number from 1 to 255, followed by 
Enter, will repeat a keystroke (or a sequence of keystrokes) every that many sec- 
onds. This is used mainly with AutoPilot (Ctrl-Tab, A below). 

Ctrl-Tab, A. Activates AutoPilot. At the beep, enter up to 8 keystrokes that 
you want repeated, then press Enter. If you want an Enter keystroke to be part of 
the sequence, press Right Shift-Enter. After Enter is pressed, the sequence will 
repeat at the rate you have set with Ctrl-Tab, S. To stop (and erase) the repeating 
sequence, press any key. However, if you want to use this sequence again, press 
the Right Shift key. Pressing the Right Shift key stops the action and saves the 
keystroke sequence. To reactivate AutoPilot (using these keystrokes), press Ctrl- 
Tab, A. To erase a keystroke sequence that has been saved by pressing Right 
Shift, without restarting AutoPilot, turn the Caps key ON, then press Ctrl-Tab, 


A. 
Note: Because of the peculiar nature of the programs KIM’s, there are actu- 


ally two AutoPilot routines. Therefore, an AutoPilot sequence that has been 
defined outside a KIM won’t work inside a KIM, and vice versa. Use Ctrl-Tab, 
A, with CAPS turned ON, to destroy saved keystrokes before ‘‘hooking”’’ and 
entering a KIM, or before leaving a KIM. Pressing and releasing the Ctrl, Alt, or 
Shift keys will count as one of the eight permitted keystrokes while inside a KIM, 
while these key presses DON’T count against the eight when outside a KIM. Use 
slow speeds (Ctrl-Tab, S speeds) when AutoPilot is active. Some of AutoPilot’s 
keystrokes may be lost if they are repeated too rapidly. 

A single PgDn keystroke can be set to repeat at a comfortable pace, to let you 
read a document in your word processor without touching the keyboard (you 
should disable screen blanking while doing this). Two keystrokes, ‘‘O” and “,’, 
can be set to fill BASIC DATA statements with zeroes. To snoop through the 
BIOS ROM using DEBUG’s UNASSEMBLE command, set the repeat to every 
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five or ten seconds and the keystrokes to U and right Shift-Enter. When some- 
thing interesting appears, press right Shift, examine it more closely, then con- 
tinue snooping with Ctrl-Tab, A. 

Ctrl-Tab, R. At the beep, enter the number of null keystrokes to insert 
between each “real” keystroke to inhibit repeating key overshoot, then press 
Enter. You may never use this command. The majority of programs use the key- 
stroke buffer supported by the BIOS (delineated by the two words at 40h:80H). 
POWERKIT sees to it that, while a key is repeating, this buffer never contains 
more than one keystroke. Hence, overshoot is impossible. 

However, KIM’s (see below) and some non-KIM’s maintain their own key- 
stroke buffers and couldn’t care less that your cursor keeps moving after you 
release it. Experiment with combinations of Ctrl-Tab, F (repeat speed) and Ctrl- 
Tab, R. Ctrl-Tab, R works best with slower (55 and below) Ctrl-Tab, F speeds. 
Overshoot may not be eliminated, but is almost always reduced. For example, 
setting Ctrl-Tab, F to 92 and Ctrl-Tab, R to 3 eliminates overshoot in QuickBA- 
SIC 3.0—a non-KIM which, nevertheless, keeps its own 8 keystroke buffer. Set- 
ting Ctrl-Tab, F to 37 and Ctrl-Tab, R to 5 only reduces overshoot in 
QuickBASIC 2.0—a KIM which must be “hooked” (see below), and which 
keeps a 16 keystroke buffer. 

Note: You may want to set Ctrl-Tab, R to zero when overshoot inhibit is not 
needed. Some programs object mightily to the null keystrokes POWERKIT uses 
to control overshoot. PC-Write, for example, sounds like a moonstruck cricket 
when nulls are set to greater than zero. 

Ctrl-Tab, H. The HOOK command is designed to outwit those application 
programs called ‘Keyboard Interrupt Monopolizers,” or KIM’s for short. You 
probably have a KIM in your library. It’s a program such that after you load it, 
your favorite pop-up utilities won’t work until you exit it. Activate HOOK just 
before you load the KIM. If you hear a beep when the KIM starts to execute, then 
HOOK probably has intercepted the program successfully and your pop-ups 
(including POWERKIT) should work. Deactivate HOOK after you leave the 
KIM by entering Ctrl-Tab, H again. No beep this time. 

Ctrl-Tab, V. Opens (and closes) a view-port into the keystroke buffer. Your 
most used applications probably have become so familiar to you, you know long 
beforehand what comes next and what you want to do about it. However, distrac- 
tions occur and you can “lose your place” while typing “‘blind”’ into the key- 
stroke buffer. At these times a view-port is useful. Reenter the command to close 
the view-port. 

Ctrl-Tab, L. Lets you blank the screen and lock up the keyboard. After 
pressing Ctrl-Tab, L, the screen will blank (if you haven’t disabled blanking). At 
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the beep, just press Enter if you want no password protection, or enter up to a 
four keystroke password, then press Enter. To get your machine back, press and 
release the right Shift key and reenter the password. Incidentally, your machine 
will go on computing while locked, if no keyboard input is needed. 

Ctrl-Tab, D. At the beep, entering a number from 1 to 60, followed by Enter, 
sets the display to turn off after one to sixty minutes of keyboard inactivity. This 
is important for monochrome displays, to preserve their phosphor coatings. 
POWERKIT’s default setting is screen blanking disabled because blanking the 
screen may damage some HERCULES display adapters. To enable screen blank- 
ing, enter Ctrl-Tab, D, (1-60), from the keyboard, or put the line DEVICE= 
POWERKIT.OBJ /d(1-60) in CONFIG.SYS. 

Blanking the display presents special problems, not so much in turning off 
the screen, as in turning it back on in the same state as it was. There are literally 
thousands of combinations of DOS versions and display adapters. Many of these 
combinations require slightly different blanking techniques. 

Ctrl-Tab, G. At the beep, press the key you wish to use with Ctrl to signal 
POWERKIT. Some call this a HOT key. Use Ctrl-Tab, G before you load a pro- 
gram to which Ctrl-Tab means something. The keys left and right Shift, Ctrl, 
Alt, Caps, Num Lock, and Hold won’t work as HOT keys. 

Attributes of the Hold and PrtSc keys. The two most dangerous keys on your 
keyboard are PrtSc and Hold (this key sometimes labeled Pause or Scroll Lock). 
If you happen to press PrtSc or Shift-PrtSc with no printer attached or Ctrl-Tab 
PrtSc activated, your machine may go to sleep. When you press PrtSc now, your 
machine will only balk, ending with the phrase Abort, Retry, Ignore?. Press 
PrtSc, then “‘A” (in that order) to solve the problem. 

On many machines, pressing the Hold key freezes the display until you press 
Hold again. If you unknowingly press Hold, you might press a few other keys 
before you press Hold again, and those extra keystrokes could end up where you 
don’t want them. Now, a beep will let you know Hold has frozen the display. 
Press Hold again to return to normal. 


Author/Source Copyright 1987 by John H. Brooks. This shareware program 
is priced at $9.95 from Central Data Services, 1641 Winoma Court, Denver, CO 
80204 (303)595-4218. 
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QUICKEYS.COM 


Purpose Increase type-a-matic speed. 
Hardware IBM PC or XT or compatible. 
Software DOS 2.0 or later. 


Description/Features QUICKEYS is a memory-resident utility which allows 
you to double or triple the type-a-matic speed on PCs, XTs, and compatibles. 
This program is useful in increasing the speed of word processor cursor move- 
ments with the arrow keys. It would make a useful addition to your AUTOEXEC- 
BAT file. To invoke the program, type QUICKEYS at the DOS prompt. 


Author/Source See PC Magazine, Vol 5, No 5, March 11, 1986. 


54 


Keyboard and Screen Enhancing Utilities 


SCRLK Y.COM 


Purpose Improves screen scrolling control. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features  SCRLKY improves the DOS control over screen scroll- 
ing from the awkward use of Ctrl-S or Scroll Lock. To use the program, type 
SCRLKY at the DOS prompt or add SCRLKY to your AUTOEXEC.BAT file. 
The program automatically attaches itself to DOS and returns you to the DOS 
prompt. 

When text is scrolled on the screen, you can invoke SCRLKY by hitting the 
Scroll Lock key in the upper right-hand corner of the keyboard. This will stop 
scrolling. To scroll up one line, hit the right-shift key. To scroll up one page, hit 
the left-shift key. To end the SCRLKY functions, hit the Scroll Lock key again. 


Author/Source Unknown. 
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SETKEY.EXE 


Purpose Set function-keys at power-up. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SETKEY can set all your function keys at once by just 
inserting one line in your AUTOEXEC.BAT file. The function keys may be set to 
your own custom commands or keystrokes. For instance, you could set F1 to 
clear the screen and load your word processor, F2 to supply the hard disk direc- 
tory, etc. Follow these steps to customize SETKEY: 

First, using a text editor or Edlin, the following line must be inserted in your 
AUTOEXEC.BAT file: 


SETKEY FROM SETKEY.WS 


This command will set your function keys using a file called SETKEY.WS as 
input. The input file is required to have a file extension of WS. 

Second, using a text editor or Edlin, the SETKEY.WS file will be created 
using the following format: 


fl =cls# f6=cd \ pb# 
f2=cd\# f7 =cd \ symphony# 
f3 = dir/w# f8 =cd \ msword# 
f4 = dir. .# f9 =setkey ?# 


f5=cd\lotus# f10=setkey off # 


You will notice that function keys 1 thru 8 are DOS commands; these are 
only examples for ease of explanation. The commands are followed by a pound 
sign—this represents a carriage return and results in immediate execution of the 
command. However, it is not a requirement to include the pound sign. The func- 
tion keys may be set to represent any command or filename that you can type at 
the DOS prompt. F9 in the above example is used to display the settings for the 
function keys as set by SETKEY. 

In order to run any software that requires use of the function keys, you must 
first turn off SETKEY. F10 in the above example will accomplish this. 

The SETKEY. WS file and the SETKEY.EXE must reside on the same disk- 
ette or in the same directory. 


Author/Source Ray Sauter 
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SMACS.COM 


Purpose Excellent keyboard macro program. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SUPER MACS lets you redefine your keyboard, write 
the current screen out to an ASCII file, print concurrently in DOS 3.0 or greater, 
and load and save files of keyboard macros from within other applications. After 
it has been run, SUPER MACS terminates and remains resident in memory. 
Then, simply by pressing a couple of keys, you can call up the menu of com- 
mands from within most any program. 

To load SUPER MACS, type SMACS at the DOS prompt. You may pass a 
macro file name on the command line. SUPER MACS will show that it has been 
activated, load any macro file parameter, then you will return to DOS. If you try 
to load SUPER MACS a second time, without any parameters it will inform you 
that it is already loaded. However, if you run SUPER MACS again and pass a 
macro file name parameter, that macro file will load into memory and SUPER 
MACS will exit back to DOS. SUPER MACS defines three ““HOT”’ keystrokes, 
Alt-Tilde, Alt-Quote, and Alt-Space. Alt-Tilde calls up a menu of choices which 
let you work with files and define macros. Alt-Quote toggles macros on and off. 
Alt-Space lets you read characters off of the screen into the keyboard buffer. All 
of these routines are independent of the others with one exception, when you are 
reading characters from the screen, the two other pop-up routines won’t work. 
By defining a macro, then reading off the screen into the macro, you can cut and 
paste from program to program. 

The SUPER MACS menu, accessed by pressing Alt-Tilde, offers you eight 
command options. These options are as follows: 


(D)efine - Define a keyboard macro. 

(L)oad - Load a disk file of keyboard macros. 
(M)erge - Merge a file of macros. 

(S)ave - Save current macros to a file. 

(C)lear - Erase all current macros. 
(W)riteScreen - Write the current screen to a file. 
(P)rint - Print a file in DOS 3.0 or greater. 
(Q)uit - Quit and return from SUPER MACS. 


When the menu appears, you are presented with the words and the prompt 
“Choice >.” To execute any available command simply type in the first letter of 
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the corresponding word. You will then be prompted through the rest of the com- 
mand. Following, you will find instructions on using each available command. 


Command word: Define 

You type: D 

Purpose: Defines a single key as one or many other keys. 

Usage: After summoning the menu, type D for define. SUPER MACS will 
then prompt you for a key to define. At this point, simply strike the key that you 
want to define. If you change your mind and don’t want to define a key, holding 
Ctrl then typing the key with number 2 and the @ character will return you to the 
menu. After you strike a key to define, you will be asked to enter the expansion. 
The expansion is up to 1,000 keystrokes that you want to replace the key when it 
is subsequently struck. When entering the expansion, you can enter any keys just 
as you would type them. Nonprintable keys will appear as highlighted characters 
or numbers. Because you can place a backspace in a macro, the backspace will 
not act as an editing key. Instead, to erase one previous character, you must hold 
Alt then enter the left parenthesis. To erase everything in a macro and return it to 
its original value, hold Alt then press right parenthesis. 

If you want to read a macro from the screen, when you are prompted for the 
expansion, use the Alt-Space pop-up. See below for details. When you are fin- 
ished typing the expansion, holding Ctr] and pressing the key with 2 and @ will 
return you to the main menu. 


Command word: Load 

You type: L 

Purpose: Loads a previously saved file of keyboard macros. 

Usage: To load a macro file, first type L. SUPER MACS will then ask you 
for a macro file to read. Simply enter an existing macro file name, along with 
disk drive and path information if necessary, then hit Return. SUPER MACS will 
then erase all current keyboard macros and activate the keyboard definition 
which is stored in the named macro file. 


Command word: Merge 

You type: M 

Purpose: Merges a previously saved file of keyboard macros with the cur- 
rently defined macros. If a key is defined both currently and in the file, it will be 
overwritten by the file definition. 

Usage: Merge works almost exactly the same as load except that the current 
macros are not erased. 


Command word: Save 
You type: S 
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Purpose: Saves all current macros to a disk file for later recall with the Load 
or Merge commands. 

Usage: To save a file of macros, simply type S. SUPER MACS will then ask 
you for a file name to write. Enter the name of the file you wish to be saved, 
along with drive and path information if necessary, then hit Return. All current 
macros will be saved. If the name already exists, it will be overwritten. 


Command word: Clear 

You type: C 

Purpose: Clears all currently defined macros and restores the keyboard to its 
original state. 

Usage: Type C. SUPER MACS will ask you if you are sure that you want to 
erase all currently defined macros. If you type Y, all current macros will be 
erased. If you simply want to temporarily disable macros, just hold Alt and strike 
the single quote. This actually toggles macro processing both on and off. When 
the SUPER MACS menu is popped up, macro processing is always turned on. 


Command word: Write 

You type: W 

Purpose: Writes the current screen (without the SUPER MACS menu) to an 
ASCII file. Non-ASCII characters are ignored. 

Usage: Type W. SUPER MACS will ask you for a file name. Enter a file 
name, including drive and path information if necessary, then hit Return. SUPER 
redMACS will then write the screen to that file. 


Command word: Print 

You type: P 

Purpose: Prints an ASCII file while you continue to work. Works with DOS 
3.0 or greater only. 

Usage: Type P. SUPER MACS will ask you for a file name to print. Enter 
the file name then Return. Include drive and path information if necessary. The 
file will start printing and you may return to your previous work. Before using 
this command, you must install the DOS PRINT utility. 


Command word: Quit 

You type: Q 

Purpose: Returns you to the program that SUPER MACS interrupted. 
Usage: Enter Q. 


The Screen Reader 


As noted above, Alt-Space provides a means whereby you may read charac- 
ters from the screen and into the keyboard buffer. Here is a more detailed 
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description of this feature. When you press Alt-Space, you will know that the 
screen reader is active because the cursor grows fat. When this happens, the cur- 
sor keypad, Ctrl, and Tab keys will help you move around. The cursor movement 
keys work as follows: 


Left arrow Move one space left 

Right arrow Move one space right 

Up arrow Move up one line 

Down arrow Move down one line 

Ctrl-Left | arrow,Shift- 

Tab Tab to next 8th space 

Ctrl-Right arrow,Tab Tab left to last 8th space 

Home Move to beginning of current line 
End Move to end of current line 
Ctrl-Home,Ctrl-PgUp Move to top of screen 
Ctrl-End,Ctrl-PgDn Move to bottom of screen 

PgUp Move up to closest 5th line 

PgDn Move down to closest 5th line 
Return Mark beginning and end of window 
Esc Back out one step at a time 


After you select a window by marking the upper left corner with a 
<Return> then marking the lower right corner with a < Return>, the charac- 
ters within the marked window will be passed through the keyboard into the cur- 
rently running program. If you are currently defining a keyboard macro, the 
characters will be deposited into the macro definition. 


Example DOS.MAC is a sample macro file that contains a few pre-defined 
macros to make DOS easier to use. Their definitions follow: 


Alt-D = dir 

Alt-E = erase , (del ) 

Alt-P = path 

Alt-C = copy 

Alt-R = ren 

Alt-F = find 

Home = F5 _ (edit on new line) 

End = F3_ (restores previous line) 
Ctrl-right arrow = F3 (restores previous line) 


Ctrl-left arrow 


Author/Source (©) 1986 Sunny Hill Software 


Esc (rejects current line) 
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SNAPSHOT.COM 


Purpose Takes a “‘picture”’ of the video display and saves to a disk file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _ SNAPSHOT allows you to take “‘pictures”’ of the video 
screen and save them to disk. It may be installed as a memory resident program. 
The format of the command is: 


SNAPSHOT s=res c=n f=filespec b=on 


S= res causes the program to become resident. 

c=n provides background color for review screen. (n=1,2,..6) 

f= filespec name and location of where snapshots should be stored. There must 
be no file extension. E.g., c: \ subdir \ snap 

b=on for PC-TYPE owners, this option will distinguish between high and low 
intensity and turn bold printing on or off accordingly. 


The review screen will be black and white. Snapshots will be saved in files 
SNAPSHOT.NN on default directory where NN will be 01, 02, .... 99. 
To take a snapshot, press Alt-Ctrl P. To review snapshots, press Alt-Ctrl R. 


Author/Source Jim Button, PO. Box 5786, Bellevue, WA 98006 
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SPEEDKEY.COM 


Purpose Speeds up the keyboard repeat function. 
Hardware No special requirement. 
Software DOS 1.0 or later. 


Description/Features To use SPEEDKEY, simply type “SPEEDKEY ”’ at the 
DOS prompt. The program then loads, initalizes, and returns to DOS. You may 
now run any other DOS program (except BASIC, see below). SPEEDKEY is 
completely invisible to other programs. 

The interrupt handlers in SPEEDKEY do something that from a program- 
ming standards perspective is blatantly illegal. They actually jump into the mid- 
dle of a ROM BIOS routine rather than enter the routine via the conventional 
method (using the INT instruction). Because this is in violation of the established 
programming standards, the initialization part of the program verifies that the 
version of BIOS encountered is one of the recognized versions (there are four of 
these). According to the author, the only program he has found that will not work 
properly with SPEEDKEY is BASIC and BASICA. 


Author/Source John B. Zuckerman 
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STACKEY.COM 


Purpose Allows batch files to deliver keystrokes within the programs invoked 
by a batch file. 


Hardware No special requirement. 


Software DOS 2.0 or later. 


Description/Features STACKEY is a utility which automatically places key- 
strokes in your keyboard buffer. It is intended for use in connection with batch 
files. A typical example of a batch file ‘“‘turb.bat” using STACKEY: 


stackey “YW %1”CR“E” 
turbo 


Entering ‘“‘turb myprog”’ at the DOS command line starts the batch file with 
myprog as %1. STACKEY has the command line passed to it by the batch proc- 
essor with %1 already replaced by myprog. Thus, STACKEY places in the key- 
board buffer the text: ““YWmyprog”’ followed by a carriage return, followed by 
the letter ‘“‘E”’. These characters wait in the buffer until a program requests key- 
board input. The batch file then loads turbo which requests input and gets it from 
STACKEY. Y answers yes to the first question, W is for work file, myprog + CR 
loads myprog.pas and E calls up the editor. This hardly uses the power of 
STACKEY; you can stack any function key or legal Alt-key combination; you can 
even stack today’s date or the current directory name. 

Loading and Using STACKEY. The first time that STACKEY is invoked, it 
loads a small resident portion which is permanently resident taking 640 bytes 
with a default keyboard stack of 128 keystrokes (this can be changed; see below). 
It displays the message: 


Resident part of STACKEY now in place. 


and proceeds to read its command line. At later times, STACKEY will find itself 
in memory and only read its command line. 

STACKEY will place keystrokes in its stack according to the rules of syntax 
described below. If there is a syntax error, it will exit with no keyboard stacking 
and give an error message. For example, saying 


stackey "hello “CRthere 
will result in the error message 


Oops! There is an error on the STACKEY command line. 
“hello "CRthere 


A 
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The arrow (shown as a caret here) will point to the first place on the line that 
STACKEY was unable to interpret in the command line, which to send “hello” 
in one line and “‘there”’ on the next should have said 


stackey “hello “CR” there” 


The command line is parsed into parts consisting of text between quotes, 
two-character special codes, hex and decimal input, delays and special com- 
mands. Spaces between the parts are optional so that 


stackey F1”hello”“r@E 

is the same as 

stackey F1 “hello” “r @E 

or even 

stackey F1 “hello” “r@e 
but 

stackey F 1”hello”*r@E 


which splits the two character code F1 will result in an error message. 

Stacking text. Most often, you will want to stack ordinary alphanumeric 
data—that is, the white letters in the center of the keyboard including the num- 
bers, punctuation, braces, etc. You do this by placing the text within quotes on 
the command line asin _ 


stackey "hello there” 
or 
stackey ‘hello there’ 


Either single or double quotes can be used. Once a quote occurs on the line, 
every letter until a matching quote OF THE SAME TYPE occurs, so to place 
< ‘“‘Hi!’”’, he said> in the stack, you can use 


stackey '”Hi!”, he said’ 


You cannot stack both types of quotes within one string but you can stack strings 
with both types of quotes by using more than one string. For example, to stack 
< ‘J can’t come’’, he said> use 


stackey '”| can’ ”’” ‘t come”, he said’ 
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Later, we will describe the command codes SQ and DQ for placing quotes. You 
could also use: 


stackey DQ”1 can’t come”DQ", he said” 


to stack the above string. 

While you will mainly stack ASCII characters corresponding to the white 
keys between quotes, you can stack an ASCII character such as the graphics char- 
acters. STACKEY will simulate the hitting of the A key if you use stackey ‘A’; it 
will simulate entering an ASCII code above 128 as if it were entered from the 
Alt-numeric keypad. 

Two-character Codes Many keys on the keyboard do not correspond to 
any ASCII character. For these and also for a few ASCII characters, STACKEY 
recognizes special two-character codes. 

The first of these can be a special symbol such as *, @ or #. Because some 
programs give special meaning to some of these codes, they have been made 
redundant. That is, as the FIRST character in these codes: 


~ meansthesameas % 
means the same as @ 
means the same as_ # 
means the same as $ 


~—=_ —-~ 


This replacement is only effective for the first character, so that you cannot 
replace ** by ~ ~ but only by ~%. If you need to stack a control-* and * has a 
special meaning, you will have to use another method like hex codes. 

You stack function keys using one of F,S,C,A (for function, shifted function, 
control function and alt function) followed by a single digit; 0 stands for 10. Thus 
Ctrl-F10 is stacked with CO and 


stackey C2 A3 $5 FO 


would stack the sequence Ctrl-F2, Alt-F3, Shift-F5, F10. You may use either 
uppercase or lowercase for the key letter f,s,c,a. Do not confuse *1 (for Control- 
End) and C1 or @1 (for Alt-1) and Al. 

You can stack the numbers on the numeric keypad with NO,...,N9, the 
numeric decimal point (shift del) with N, and the grey +, — and * with N+, 
N-— and N*. 

The BIOS also makes codes for certain Alt key combinations. The legal pos- 
sibilities are Alt- followed by any letter or number (top row numbers) or the fol- 
lowing special symbols: — =. These can be stacked by proceeding the key with 
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@, e.g. stackey @a @2 @- will stack Alt-A followed by Alt-2 followed by Alt- 
minus. It does not matter if you use upper- or lowercase letters or if you use @! 
rather than @1 or @_ rather than @-. 

Similarly, available control combinations are the letters A—Z,[, \ ,],*,_,°,@ 
left arrow, right arrow, Home, End, PgUp, PgDn, PrtSc. These are entered 
using the * (or ~) as the first key. *A through *Z will enter those control codes 
as will *[, *\, etcetera. The six keys, on the numeric keypad corresponding to 
“Home, etcetera, can be entered with the corresponding numbers 1,3,4,6,7,9. 
Thus 


stackey *z *Z *[ *6 


will stack two Control-z’s, an Escape and then Ctrl-right arrow (but the 
““escape”’ here is entered as if you depressed the Control key and then struck [; to 
enter an Escape as if you hit the Escape key, use $e or ES as described below). 
For the letters, * may be followed by an upper- or lowercase letter. For the 
remaining combinations, only one possibility is allowed. For example, do not 
confuse “and “6. 
There are two-character mnemonics for special key combinations as follows: 


LA Left Arrow 

RA Right Arrow 

UA Up Arrow 

DA Down Arrow 

PU Page Up 

PD Page Down 

HM Home 

EN End 

IN Insert 

DE Delete 

G+ Grey plus (“+”’ will send the top row +; also N+) 
G- Grey minus (‘‘—” will send the top row —; also N-) 
G* Grey star (“‘*”’ will send the top row *; also N*) 
CP Control PrtSc 

TA or TB Tab 

ST or BT Shift Tab (=Back Tab) 

ES Escape _ (also $e) 

BS Backspace (also $h) 

SP Space bar 

CR Enter 

LF Ctrl-Enter 
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DQ _ The double quote ” 
SQ. The single quote ’ 


These codes can be entered in upper- or lowercase. 


Status-toggles. You can turn NumLock, etc. on or off from the STACKEY 
command line. The syntax is: 


+N Turn NumLock on 

—N_ Turn NumLock off 

+C Turn CapsLock on 

-C Turn CapsLock off 

+S Turn ScrollLock on 

-S Turn ScrollLock off 

+I Turn BIOS insert mode indicator on 
—I Turn BIOS insert mode indicator off 


Prompt meta-strings. STACKEY supports the full set of meta strings allowed 
in the DOS PROMPT command as well as the added strings supported by the 
program SEND.COM of Howard Rumsey and Barry Simon. Specifically: 


$$ The character ‘‘$” 
$t | The time in HH:MM:SS.hh format 
$d The date in DAY MM-DD-YYYY format 
e.g. Tue 9-30-1986 
$p The current path in full, 
e.g. C: \ BIN \ FOO 
$v The current DOS version 
$n The current default drive 
$g The character “>” 
$1 The character “<<” 
$b The character ‘‘|” 
$q The character “=” 
$h The backspace 
$e The ESCape 
$_ CR/LF (i.e. <Enter> followed by Ctrl-< Enter > 
$P same as $p in the root dir and as $p \ elsewhere 
$T time in HHMM format 
$M _ month in MM format, e.g. 09 
$D day in DD format, e.g. 03 
$Y year in YY format, e.g. 86 in 1986 and 01 in 2001 
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There is a difference between uppercase and lowercase after the $. 

Decimal and Hex codes. You may enter various ASCII key combinations 
from the keyboard by pressing Alt and tapping one to three digits on the keypad 
(or by pressing Alt-left shift) and then releasing Alt. To stack keystrokes as if 
entered in this way, use \ followed by a decimal number, so 


stackey \104\ 101 \ 108\ 108\ 111 


at the DOS command line will cause ‘“‘hello”’ to appear on your screen. 

Keystrokes are stored in the buffer as a set of two hex bytes: a scan code and 
an ASCII code. You can enter such a combination by typing an X followed by 
four hex digits. The first two are the scan code and the second pair the ASCII 
code. For example 


stackey X2368 X1265 X266C X266C X186F 


at the DOS command line will cause “hello” to appear on your screen. The hex 
digits a-f and the letter x can be either upper- or lowercase. 

Because they are used internally by STACKEY, the scan codes FF and FE 
(which are not legal anyway) are not allowed and you will get an error message; 
otherwise, STACKEY will place in the keyboard buffer whatever combination 
you tell it to—even if it is an illegal combination. DOS will only pay attention to 
the ASCII half of such combinations as will many programs. Some keyboard 
macro programs will allow such possibilities. For example, KEYWORKS associ- 
ates Ctrl-up arrow (a keystroke not supported by BIOS) with 8448. Stackey 
X8448 will call up the KEYWORKS macro assigned to Ctrl-up if one is defined. 

Repeats. If you need to stack ten left arrows, you will not appreciate having 
to type LA ten times (nor do you want to take that much space in STACKEY’s 
buffer). Thus STACKEY allows a key repeat command. # followed by a decimal 
number from 1 to 256 will result in the next keystroke being repeated that number 
of times, so 


stackey #7 F1 


will stack 7 F1’s while stackey #7 ‘“‘hello” will stack hhhhhhhello. Trying to 
repeat a repeat command (as in #2#4) or a delay (as in #2W6) is not recom- 
mended. 

Delays. There will be times that an application program will flush the key- 
board buffer before asking for a keystroke. This is to force you to respond, or to 
make sure the response is not accidental. If you just stack the strokes you want 
they will get flushed out. A famous example of this is 1-2-3. STACKEY allows 
you to stack a delay into the stack so that when those strokes are gotten to, 
STACKEY will pause before inserting them in the buffer. You specify the time to 
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pause in 55 millisecond units (clock ticks; there are about 18.2 per second). This 
is done with the command Wn where n is from 1 to 256 so 


stackey W36 ES 


will Wait about 2 seconds before it puts an <Esc> into the buffer. You can use 
either w or W. While this limits the pause to about 14 seconds, you can stack 
waits so 


stackey W255W255W255W255 ES 


would program in a wait of about one minute. 

Flushing and Quitting. As long as there is room in STACKEY’s internal 
buffer, you can stack additional keystrokes with a second STACKEY command. 
If you enter a ! in a STACKEY command line, then STACKEY will flush its 
buffer, i.e. clear it and reset its internal pointer to the bottom of the stack. It will 
not flush DOS’ buffer. Thus, the batch file: 


stackey ”abcdefghij1234567890” 
stackey ! 


will display abcdefghij12345 on the screen when it is over. STACKEY will im- 
mediately place the first 15 keystrokes in DOS’ buffer and then flush the remain- 
ing five from its buffer. 

If STACKEY finds a ; (lowercase only) in its command line, it will quit 
interpreting the command line at that point. This is to allow you to place com- 
ments in your BATch files. 

Enlarging the buffer. STACKEY will use a default buffer allowing 128 key- 
strokes to be stacked. The first time that STACKEY is loaded, you can tell it to 
set aside a larger buffer by including the buffer size in number of strokes between 
slashes so 


stackey /2000/"hello there” 


as an initial command would set aside a 2000 stroke buffer and then stack “‘hello 
there”’ in that buffer. Any number between 1 and 10000 is allowed for the buffer 
size. The size is given in keystrokes; each keystroke requires two bytes of resi- 
dent memory so a buffer size of 2128 would increase the amount of RAM taken 
by the resident portion of STACKEY by 4000 bytes. 

Once STACKEY is loaded it cannot change the size of the buffer in the 
loaded copy. Further calls to STACKEY find the resident copy and use it and do 
not load another copy. If a copy is loaded and /xxxx/ appears on the command 
line, you will get an error message. You can however choose to load a new copy 
of STACKEY with any buffer size you want. The old copy remains in memory 
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but will be unused; STACKEY always finds the last copy loaded in memory. You 
tell STACKEY to load a new copy by placing a * after the first / in the buffer size 
command so 


stackey /*2000/" hello there” 


will load a new copy of STACKEY with a 2000 stroke buffer. If STACKEY can- 
not fit the characters on the command line into the buffer, it prints an error mes- 
sage, showing you where the overflow occurs, beeps and places NO new 
characters in the buffer. 


Author/Source (©) 1986 Barry Simon and Richard Wilson. STACKEY is 
POSTWARE: if you like it, send a postcard addressed to the authors at 253-37 
Caltech, Pasadena, CA 91125. 
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COMMERCIAL KEYBOARD UTILITIES 


CRUISE CONTROL 
Revolution Software, Inc. 
715 Route 10 East 
Randolph, NJ 07869 


Cruise Control improves control of the screen cursor in three ways. The 
speed of cursor movement may be selectively increased or decreased (see the 
freeware program QUICKEYS in this book). Secondly, “‘anti-skid braking”’ pre- 
vents the cursor from running-on by adapting to the speed at which your applica- 
tion program can process keystrokes. Thirdly, you can repeat any key or key 
combination by pressing a special key first. 

The software also includes a time/date stamp macro and an adjustable auto- 
matic screen blanker (to prevent screen phosphor burn-in). 


PC-LOCK 

Johnson Computer Systems 
20 Dinwiddie Place 
Newport News, VA 23602 


PC-LOCK provides security from prying eyes to your PC by locking the key- 
board, disk drives, and peripherals to password access. The program appears as 
a device driver in your CONFIG.SYS files, but is masked under an unsuspecting 
technical term that should provide camouflage when the program is inactive. One 
can hide the true password among incorrect characters to avoid persons looking 
over your shoulder. It can run applications that require no keyboard input while 
blanking the screen so the machine appears off. It is a shareware program that 
may be found on many BBS services, or obtained from Johnson Computer Ser- 
vices for a registration and handling fee of $21.50. 
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THIS CHAPTER discusses printer utilities, including programs to obtain spe- 
cial features from your printer. Some of the printer control utilities are memory- 
resident, allowing access to these functions from within another application 
program. | 


Printer Utilities 


EZSWAP.COM 


Purpose Swaps LPT1: and LPT2: to redirect printer output. 
Hardware One printer assigned to LPT1:, one assigned to LPT2:. 
Software DOS 2.0 or later. 


Description/Features This program is useful for those who have two printers 
connected to LPT1: and LPT2:. Because some programs only direct printer out- 
put to LPT1:, this program provides a convenient means of redirecting output. 
The printers may be any combination of serial or parallel. By typing EZSWAP at 
the DOS prompt, all output to LPT 1: will be redirected to LPT2: and vice versa. 
The program can be run again later to return the printer assignments to their orig- 
inal state. 


Author/Source Unknown 
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FASTPRT.COM 


Purpose Speedup utility for PrtSc (print screen) function. 
Hardware No special requirement. 
Software DOS. 2.0 or later. 


Description/Features  FASTPRT is a speed-up utility for the PrtSc function. 
For all printers, it allows you to terminate an active PrtSc operation early (if 
you’ve seen enough or changed your mind, for instance). 

For printers which don’t have the foresight to ignore trailing blanks and 
empty lines, FASTPRT provides this capability for them. This look-ahead feature 
allows a screen with trailing blanks and blank lines to print in a fraction of the 
time it takes if all these extraneous blanks have to be “‘printed.” 

To install FASTPRT manually, type FASTPRT. FASTPRT becomes an exten- 
sion to DOS and remains available until you turn off your machine or press Ctrl- 
Alt-Del. 

If you would like FASTPRT to be available whenever DOS is loaded, use the 
following procedure with all your system diskettes (i.e., any diskette(s) you 
might place is drive A before you start or restart DOS): 


1) Make sure you are in DOS command mode and the default drive is drive A 
(the prompt A> should be displayed on your screen). 

2) Insert your system diskette in drive A. (Be sure to remove the write-protect tab 
before insertion.) If you have a two-drive system, insert the FASTPRT diskette 
in drive B. If you have a single drive system, insert the system diskette when- 
ever you are prompted to “insert diskette for drive A” and insert the 
FASTPRT diskette whenever you are prompted to “‘insert diskette for drive 
B.” 

3) If your system diskette contains DOS 2.0 or above, type in: 


B:INSTALL TWO A 

4) If you start DOS 2.0 or above from a fixed disk, type in: 
B:INSTALL TWO d 
where d is the correct drive designator for your system disk. 


FASTPRT will now be installed automatically whenever you start or restart 
DOS. 
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Once FASTPRT is installed, you start copying your screen to the printer the 
same way as you did before. Just press the PrtSc key while holding down either 
the right or left shift key. 

If you want to stop printing before the entire screen has been printed, just 
press the same Shift-PrtSc combination again. Printing will stop at the end of the 
line currently being printed. 

FASTPRT will work in conjunction with the GRAPHICS command that is 
available to users of DOS 2.0 and above. FASTPRT will handle the Shift PrtSc 
function if your display is in text mode, and GRAPHICS will handle it if your 
display is in graphics mode. Please note that the ability to terminate a PrtSc func- 
tion prior to completion is not available when GRAPHICS is in control. 


Author/Source © 1983 J. Craig Hill, SUNBELT COMPUTING, 1274 N. 
Emory Pl., NE, Atlanta, Ga. 30306. The author requests a $10 contribution 
from satisfied users. 
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FPRINT.COM 


Purpose Enhanced print spooling utility. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features FPRINT.COM is an enhanced print spooler for PC- 
DOS and MS-DOS. It will print a queue of files on your printer (parallel or 
serial) while you perform other tasks on the computer. FPRINT requires DOS 
2.0 or above. The first time FPRINT is executed, it will increase the resident size 
of DOS by about 3800 bytes plus the specified print buffer size (1K - 48K). 

FPRINT offers many improvements over the standard PRINT.COM sup- 
plied with DOS, including: 


Full DOS 2+ pathname support (including DOS 3.0) 

Interrupt driven (supports PRN, LPT1, LPT2, LPT3, AUX, COMI, & 
COM2) 

Supports both hardware handshaking (CTS) and XON/XOFF protocol on the 
serial ports 

Variable RAM buffer size (1K - 48K bytes) 

Compatible with the PC-DOS & MS-DOS print spoolers, and faster 

Tab expansion option (/E) 

Pagination (page numbering) with the /F: option 

1-255 copies per file using the /M: option 

Suspend/restart printing with the /S option 

Does not use up file handles (PRINT.COM uses 1 file handle for each entry in 
the print queue.) 

Up to 12 files in the queue at once 

Full programming access via the 2F interrupt 


Format 


FPRINT[ [d:] [path] [filename{.ext] } [/C] [/E) [/F[:nn] ] [/M[:nn] [/P] [/S] [/ 
A fecal 


The following features are supported: 


¢ Multiple filenames can be entered on the command line, each with 
parameters. 

¢ The global characters ? and * are permitted in the filename or extension. 

e If no path is specified, the current default directory is assumed. 
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If FPRINT is executed with no parameters, it will display the current status 
of the print queue. 
The first time FPRINT is executed, the following prompts will be displayed: 


Printer device [LPT 1]: 
Print buffer size [1-48K]: 


The first prompt allows you to specify the printer port (PRN,LPT1, LPT2, 
LPT3, AUX, COM1, or COM1). The default is the first parallel port (LPT1), 
and it will be selected if you press Return. The second prompt allows you to 
select the amount of RAM that FPRINT will use to buffer the printing file. Using 
larger buffers will increase the speed of the spooler, and decrease the interference 
with your subsequent tasks. The default buffer size is 2K. 

It is possible to configure your system to automatically answer these ques- 
tions so no user responses will be required. To do this, in your ‘“‘autoexec.bat”’ 
file place a line: 


FPRINT < FPRINT.INP 


Next, create the file FPRINT.INP with one entry for the printer port and one 
entry for the RAM buffer. For example: 


LPT1 
16 


This sets the printer port to the first parallel port and sets aside 16K bytes for the 
RAM buffer area. 


Options */C sets the cancel mode. The file preceding the /C command as well 
as all subsequent files named on the command line will be removed from the 
queue, until the end of the command line is reached or a /P is found. If you can- 
cel the currently printing file, the message: “File canceled by operator.” will be 
printed, the printer bell will sound, and the paper will be advanced to the next 
page. For example 


FPRINT test.doc/C 
cancels the printing of the file ‘“‘test.doc” and 
FPRINT test.doc/C test2.doc 


cancels the printing of the files ‘‘test.doc’’ and test2.doc.” 

*/E sets the tab expansion mode. If your printer can’t handle tabs, this will 
expand tabs to spaces. Tab expansion will remain active until the computer is 
reset. This option doesn’t require a file name. For example, 
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FPRINT test.doc/E 


*/F sets the format (pagination) mode. This will print a header on each page 
with the page number (for example, “‘Page 21”). You can specify the page length 
by /F:nn, where nn is the page length in lines (e.g., /F:54). After printing the 
specified number of lines, FPRINT will print a form feed and start a new page. If 
no page length is specified, FPRINT assumes a default of 60 lines per page. For 
example, if you type 


FPRINT test.doc/F 


“test.doc” will be printed with page number headers. Page length will be 60 
lines per page and 


FPRINT test.doc/F:48 


will print the file with page number headers. Page length will be 48 lines per 
page. 

*/M allows you to print multiple copies of a file. The maximum number of 
copies allowed is 255. 


FPRINT test.doc/M:4 


will print four copies of “‘test.doc” while only taking up 1 queue slot. 

*/P sets the print mode. The file preceding the /P command as well as all 
subsequent files named on the command line will be printed from the queue until 
the end of the command line is reached or a /P is found. Note that this command 
is normally used in conjunction with the /C command and is otherwise unneces- 
sary. 


FPRINT test.doc/C test2.doc test3.doc/P | 


cancels the printing of the files “test.doc” and ‘“‘test2.doc,” and adds the file 
‘*test3.doc”’ to the queue. 

*/S toggles the printing off and on, allowing you to pause the printer to take a 
telephone call, and then continue with no loss of characters. 

*/T cancels all files in the print queue. If a file was printing, the message 
“All files canceled by operator.” is printed, the printer bell will sound, and the 
paper will be advanced to the next page. Any commands following a /T on the 
command line will be ignored. 


FPRINT /T 


cancels the queue including any file currently printing. 
Note that the /E, /S, and /T commands do not require a filename. 


79 


Printer Utilities 


If FPRINT finds a disk or system error while printing, it will cancel the cur- 
rent file, print the error message, sound the printer bell, and advance the paper to 
the next page. Any remaining files in the queue will then be printed. 

Because FPRINT uses interrupts to control printing, it can come into con- 
flict with some other programs. BASIC, for example, will reset the serial port 
interrupts and vectors on entry and again on exit. If the FPRINT queue is empty, 
nothing unusual will happen. If, on the other hand, FPRINT is printing a file, 
there will be a slight pause as FPRINT detects the change, and resets the inter- 
rupts and vectors. 

The benchmarks were executed on an IBM PC-XT running DOS 2.1. The 
serial port (COM 1) was connected to a terminal running at 4800 baud. The paral- 
lel port (LPT1) was connected to an Epson FX-80. PRINT.COM is the standard 
PC-DOS spooler provided with DOS 2.1. The text file was 26K in length. First, 
each spooler was tested with no other system activity. Then, each system loaded 
BASICA after starting the printing (but no program was run). Finally, each 
started a lengthy compile after starting printing. The compile time is also given to 
indicate the relative system throughput. 


PRINT.COM FPRINT.COM  % Gain 


COMI: 1:04 :55 16% 
w/BASIC 5:31 :55 602% 
w/compile 5:41 55 620% 

LPT1: 6:00 5:56 1% 
w/BASIC 9:09 6:26 42% 
w/compile 10:40 6:29 65% 

Compile time 11:45 10:56 7% 


Note there is only a marginal gain in printing speed when the system is 
devoted solely to printing; however, when performing other tasks, both the 
throughput and the print speed increase significantly. The faster the printer, the 
more dramatic the speed increase. 


Author/Source © 1985 by CCG., Inc., 9 Dudley Ct., Bethesda, MD 20814, 
(301) 493-6725. A shareware donation of $15 is requested from satisfied users. 
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PC.COM 


Purpose Sends control codes to the printer. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features PC.COM is a small (128 byte) program designed to 
send control characters to your printer. The syntax of the command is 


PC x,y,z, or PCxyz 


where x,y, and z are ASCII decimal codes (1 to 25) or ASCII keyboard charac- 
ters. Codes are sent to the printer which DOS considers to be LPT1. Your printer 
manual contains the control characters or “escape sequences”’ to access special 
functions. 

This utility program differs from PRTCON.EXE (also in this chapter) in that 
it does not create a permanent program to send a specific control character 
sequence. You might want to use one versus the other depending on how often 
you will be sending a set of control characters to your printer. If you will be doing 
this frequently, PRTCON.EXE might be easier to use and doesn’t require you to 
remember the control codes for each use. 


Example An EPSON compatible printer may be set to expanded print by 
typing 

PC 27W or PC 27 8/7 

Note above that the ASCII code for W is 87. To reset the printer try 

PC 27 64 


Author/Source Mark Sawusch 
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PERFSKIP.COM 


Purpose Skips a designated number of lines over the perforations of fan-fold 
paper when printing. | 


Hardware IBM-PC OR EPSON MX-80 printer. 
Software DOS 2.0 or later. 


Description/Features PERFSKIP is a utility to skip a designated number of 
lines over the perforation of fanfold paper when printing. To invoke PERFSKIP, 
just type PERFSKIP followed by a space and the number of lines to be skipped. 
For example, to skip 6 lines type 


PERFSKIP 6 


To reset the printer simply type PERFSKIP 0. This resets the printer to skip 
O lines. 


Author/Source David Ray, P.O. Box 9697, College Station, TX 77840 
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POP-EPSN.COM 


Purpose Memory resident Epson FX/RX/MX and compatible print feature 
controller. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features | When you type POP-EPSN at the DOS prompt, a sign- 
on message will appear to let you know that the program has been installed. Once 
installed, POP-EPSN becomes a resident part of DOS, and can be invoked at any 
time, either from the DOS prompt, or from within an application program, by 
typing Alt-F10. When invoked, POP-EPSN will open a window onto the screen, 
overlaying whatever is currently being displayed, and presenting a menu of print 
features. Choose any menu item by typing the corresponding number, followed 
by a carriage return. The appropriate control codes will be sent to the printer, and 
the window will disappear, leaving the previous display intact. 


Author/Source Michael L. Yard, DataComm Consultants, 3039 Willow Pass 
Road, Concord, CA 94519. A $15 contribution is suggested from satisfied users. 
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PRTCON.EXE 


Purpose Creates printer control code .COM files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features PRTCON.EXE is a utility program designed to create 
another utility program to send control codes to your printer. You may choose any 
set of control codes to send to your printer; these may be found in your printer 
manual. For instance, you could use PRTCON.EXE to create another utility pro- 
gram called ENHANCE.COM, which in turn would send the control codes for 
bolding letters to your printer. To invoke the program, type PRTCON at the DOS 
prompt. You will then be asked to enter a file name for the new utility program, 
followed by the printer control codes to send. Actual keys such as Esc or 9 or Z 
may be used, or hit F9 and type the three-digit decimal ASCII control code. Up 
to 20 codes may be entered, and the Backspace key used to correct errors. When 
finished, hit F10 to quit and create the new utility program. 

The control code programs created may be useful in batch files to perform 
common printer control functions, such as advance-to-top-of-form or change-of- 
font. 


Author/Source Mark Sawusch 
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PRT2SC.COM 


Purpose Redirect all printer output to the screen. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features PRT2SC.COM is a memory resident program which 
redirects all printer output to the display screen instead. It remains active until the 
computer is rebooted and is activated by typing PRT2SC at the DOS prompt. 

This utility might be useful to those who are debugging programs and want 
to save time and paper usage by quickly noting the results on-screen. If your 
printer is broken or you don’t have one, PRT2SC will allow you to use programs 
designed for output to the printer. This might be useful while using a lap-top 
computer on a cross-country flight. It also avoids a system hang-up if Shift-PrtSc 
is hit by accident while a printer is not in service. 


Author/Source Dean Perry 
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PRTPAGE.EXE 


Purpose Print formatting utility including printing with pagination, spooling 
to disk, and line numbering. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features © PRIPAGE.COM is a utility designed to print a text file 
in a standard format. The user can choose the width of the line in characters, 
page length in lines, provide line numbering, and spool to the disk rather than the 
printer. The format for the command is as follows: 


PRTPAGE file [+s‘sfile’] [—p] [+n] [—h] [+h‘H’] [+ 0K] [+ 1K] [+wX] 


file = print file as drive:name.ext 
+§ = spool to sfile instead of to printer (sfile as drive:name.ext) 
-—p = do not pause for top-of-form adjust 
+n = provide line numbering 
~—h = suppress header of date, time, file 


+h‘H’ = use H as part of header instead of file 
+oK = _ offset from left by K blanks (default K =0) 
+1K page length is K lines (default K = 66) 
+wkK = width of line is K chars (default K = 80) 


Examples 
PRTPAGE letter.txt +05 +150 +w65 


would print the file “‘letter.txt”” with an offset of 5 spaces on the left margin, with 
50 lines to the page, and a line width of 65 characters. A header containing the 
date, time, name of file and page number would be automatically printed at the 
top of each page. 


PRTPAGE b:program.txt —p +n +h ‘VERSION 2.1’ 


would print the file ‘“‘b:program.txt” without pausing for top-of-form adjust- 
ment, with lines numbered, and with ““VERSION 2.1” as the header. The 
default page length of 66 and line width of 80 are used. 


Author/Source Daniel M. O’Brien, 1601 Burlington, Lisle, IL 60532. The 
author requests a shareware contribution of $10 from satisfied users. 
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PRTSCFX.COM 


Purpose Graphic/text mode printing of a screen display. 
Hardware EPSON FX and RX or compatible printers. 
Software DOS 2.0 or later. 


Description/Features PrtScFX is a screen dump program which prints a 
graphic image of a text mode display on an Epson FX or RX series printer. The 
printout looks just like a screen display, including connected line graphics. 

This is different from other graphics dumps, such as IBM’s GRAPHICS 
program. GRAPHICS dumps a graphics mode screen; PrtScFX dumps a text 
mode screen. 

PrtScFX should be run once, typically from your AUTOEXEC.BAT file. 
From then on, if you are in 80-column text mode, the Shift-PrtSc key will give 
you the prompt: 


G = text graphics dump, D = darker graphics, 
SPACE = normal dump, Esc = cancel 
You may then type: 


G for a text mode graphics dump 

D for a better quality (double-strike) text graphics dump 

Space Bar for a “normal” screen dump (passes the request on to the standard - 
or other special screen dump utility) 

Esc to cancel the screen dump request 


Either the IBM Monochrome Display or the Color/Graphics Adapter can be 
used, but only 80-column TEXT mode displays are dumped. For either display 
adapter, the printout duplicates the font of the IBM Monochrome Display. 

PrtScFX coexists nicely with IBM’s GRAPHICS program. Just run them 
both in your AUTOEXEC (in either order), and then GRAPHICS will handle 
graphics mode displays, and PrtScFX will kick in for text mode. 

Be warned that ProKey has a bug which makes it crash if it is used with 
PrtScFX. Because of this bug, PrtScFX attempts to determine (when you press 
Shift-PrtSc) whether ProKey is active. If it is, a normal screen dump is done 
instead of giving you the choice of a graphics dump. You can include both Pro- 
Key and PrtScFX in your AUTOEXEC, but if you do, you will not be able to get 
graphics dumps until you do a PROKEY/Q command to disable ProKey. 


Author/Source Michael Geary, P.O. Box 1479, Los Gatos, CA 95031. (408) 
354-0175 
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COMMERCIAL PRINTER UTILITIES 


SIDEWAYS 

Funk Software 

222 Third Street 
Cambridge, MA 02142 


Sideways is a utility program which can print any ASCII file down the length 
of a page rather than across, called “landscape” printing. This is useful in print- 
ing spreadsheets because the number of columns often exceeds the horizontal 
width of the printer. 

Printing options include type style/size, type density, and setting paper size/ 
line spacing/margins. With Lotus 1-2-3 and Symphony, the program can have 
different print options in different cell ranges. It also recognizes embedded 
printer control codes. 

The freeware utility SIDEWAYS.EXE is described in this book and provides 
the same basic function, with more limited printing options. 
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HERE ARE DESCRIBED the disk and directory maintenance utilities, includ- 
ing programs to back up your hard disk, DOS shells, utilities to find files, and 
improved methods to manage your hard disk. 

DOS provides little or no assistance with many common problems in disk 
maintenance. These include accidentally erasing a file, lost data due to damaged 
floppy or hard disk, misplaced data due to forgotten subdirectory location, and 
inefficient disk access due to fragmentation of files. 
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AD.COM 


Purpose Provides a quick, compact, alphabetized directory listing. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features AD.COM is a handy substitute for the DOS DIR com- 
mand that provides a quick, compact, and alphabetized directory listing. It is 
especially useful in dealing with a large directory that will not fit on one page 
when using DIR. The file length and time/date stamp are deleted and files are 
listed in five columns across the screen. This program would make a useful addi- 
tion to anyone’s DOS disk or directory. 


Author/Source William B. McCormick, © 1982 Quadram Corp. 
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BACKSTAT.EXE 


Purpose Shows which files have not been backed up. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _BACKSTAT will search every file on a specified disk 
and show which ones have been changed since being backed up with the DOS 
BACKUP command. This is helpful to determine whether you should back up a 
hard disk after getting a feel for the number of changes made since the last 
backup. The program checks the backup bit in the directory for each file. 

Use of this utility requires the presence of two files on the DOS disk (Vol. 
A:) at bootup time: 


CONFIG.SYS containing the line DEVICE= ANSI.SYS 
ANSI.SYS (from the master DOS diskette) 


To use BACKSTAT, type BACKSTAT d: , where d: is the identifier of the 
drive on which to do a status check. 


Author/Source Unknown 
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COVER.COM 


Purpose Prints sorted directory listing for diskette sleeve. 
Hardware EPSON/IBM compatible printer. 
Software DOS 2.0 or later. 


Description/Features This utility program prints a sorted directory listing of 
a floppy diskette in compact format, designed to fit into the sleeve along with the 
disk. Start the program by typing COVER at the DOS prompt. The program will 
ask for the drive containing the diskette directory to be listed. Type in the appro- 
priate drive letter in upper- or lowercase, without pressing Enter. Next you will 
enter a title for the diskette to appear at the top of the listing. This may be up to 44 
characters in length. Just press Enter if you do not want a title. 

The program selects the EPSON/IBM compressed print codes with “-inch 
line spacing, and 44 lines to the page. If you have a printer which is not EPSON 
compatible, you will need to patch the program using a file editor such as 
DEBUG. The sequence to initialize the printer starts at location 13C with the 
sequence 1B 30 1B 43 2C OF. Five zeros follow this sequence and these may be 
used for your printer initialization in addition to replacing the six bytes starting at 
13C. The string must terminate with a zero for the DOS call to function. The 
program automatically restores the printer to power-up defaults on exit. The 
restore sequence is 2 bytes long (1B 40) with five extra zeros for patching room. 
It begins at location 148. 


Author/Source Dan Daetwyler, Dr. Dobbs Journal, January 1984. 
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DIRTREE.COM 


Purpose Display a schematic representation of a disk’s directories and files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features DIRTREE provides a schematic representation of a 
disk’s directory structure. The information is presented in a format that is clearly 
superior to the DOS TREE command, in the form of a sideways ‘tree.’ The for- 
mat of the command is: 


DIRTREE [-ADFHNVX?] [-C length] [d: ] [path] 


where the options are: 


-A Include all entries in the tree listing. The output generated 
by this option shows files entries. 

-D _ Sort the tree with the directories at the top. 

-F _ Sort the tree with the files at the top. 

-H Include hidden entries in the tree. 

-N Do not sort the tree. 

-V___ Allow variable length columns. Each column length is opti- 
mally computed and is variable. 

-X Do not traverse the tree. 

-? — Show help for DIRTREE. 

-C [length] Set the column length to ‘length’. 


Examples 

1) Display the directory structure starting at the root of the current drive. 
DIRTREE \ 

2) Send the complete raw directory structure of drive C to the printer. 
DIRTREE -AHN C:\ >PRN: 

3) Show the help information for the program. 
DIRTREE -? 


Author/Source G.R.A.M. Associates, 450 N. Jordan Street, Allentown, Pa. 
18102. Users sending in a contribution of $10 or more will be entitled to a free 
update and notification of other utilities as they become available. 
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DISK.COM 


Purpose _ Directory searching utility. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features DISK is a more sophisticated shareware version of the 
popular WHEREIS utility program. It is a powerful directory searching program 
which will display one or all occurrences of a filename in any or all directories on 
a disk. The display line for each file indicates the complete path specification of 
all files located. Based on command parameters, the information may optionally 
include the file size in decimal bytes, the disk space allocated to the file, its per- 
cent slack space, the date and time the file was last written to, and the file attri- 
butes. The information may include subtotals by directory and a grand total con- 
cerning the files located, and the total amount of free space left on the disk. A 
command parameter is available to list the total allocated space required by the 
requested files if they were to be copied to a target disk. The output information 
may be formatted and redirected to a file usable as a batch command file. 

Although not normally listed, files with the hidden or system attribute may 
be included in the list. Normally only data file information is listed. A command 
parameter is available to list directory file information instead. The command 
format is: 


DISK[/P] [/H] [/D] [/W] [/B] [/C] [/F] [/T] [/Ra] [d:] [filename[.ext]] 


The optional filename may not include a path specification because the 
entire disk is searched by this command. 


Options: 

The /P parameter causes the display to Pause when the screen is full. When 
you are ready to continue listing the information, press any key. The Ctrl-Break 
key pair is active at this time and can abort the command without further output. 
This parameter may be used with any other parameter. 

The /H parameter permits files with the Hidden and system attributes to also 
be selected by the command. This parameter may be used with any other parame- 
ter. 

The /D parameter causes Directory files to be selected INSTEAD of data 
files. This parameter may not be used with either the /F or the /R parameters 
because file size is not computed for the directory files themselves. 

The /W parameter produces a Wide display of the data. The directory path is 
specified on a line by itself followed by lines of the filenames located in that 
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directory. Each line displayed contains five names. This parameter is only rec- 
ommended for 80-column displays. This parameter may not be used with the /B 
or /C parameters. | 

Both the /B and /C parameters produce a list, one file per line, with the path 
name Concatenated to the front of each filename located. If redirection of output 
is done to a disk file, this list is suitable for editing. With the /B parameter, each 
complete name is preceded by the characters “‘%1 ”’ and followed by the charac- 
ter ‘“‘ %2”’. If redirection of output is done to a disk file, this list is suitable for 
subsequent use as a Batch command file. These two parameters are mutually 
exclusive. They may not be used with the /W or /F parameters. 

The /F parameters gives Full information for each file. It will list the file size 
and allocated space in decimal bytes, the percent slack space, the date and time, 
and the file attributes for each file listed. (This parameter is only recommended 
for 80-column displays.) If used with the /W parameter, full information is only 
included on whatever total lines are displayed. This parameter may be used with 
the /B and /C parameters only if also used with the /T parameter. This parameter 
may not be used with the /D parameter. 

The /T parameter will cause Totals to be calculated for each directory in 
which a file is located. If used with the /B or /C parameters, this parameter will 
output only a grand total on the standard error device. 

The /Rd parameter indicates the Results of copying the selected files to 
another disk. The proposed target disk drive letter is entered immediately follow- 
ing the R. A total line indicates the allocated space required by the files on that 
disk, and the current space available on that disk. Less space than indicated 
might actually be needed if some of these files would replace existing ones on 
that disk. This parameter may not be used with the /D parameter. 

The /W, /F, /B, and /C parameters all define what information will be listed 
concerning the located file. If none are specified, the command lists the standard 
file information. The directory path is specified on a line by itself followed by 
lines of the filenames located in that directory. The display line for each file indi- 
cates the filename located, its size in decimal bytes, and the date and time the file 
was last written to. If the /D parameter was specified, the filenames are directory 
files and no filesize is listed. 

The command writes all information to the standard output device which 
may be redirected or piped. Using either the /B or /C parameters causes the head- 
ing and total lines to list on the standard error device. The command sets the 
ERRORLEVEL exit code upon completion: 


Q = normal exit 
1 = invalid input parameters 
2 = no files located 
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The DISK command has two format options (any of the parameters may be used 
with either option): 

Option I - List All Files. Use this option to list all the files on a disk. If the / ! 
D parameter is specified, this option will list the directory tree structure of the | 
disk. For example: 


DISK 
or 


DISK d: 

Option 2 - Locate Selected Files. Use this option to locate selected files on a 
disk. If the /D parameter is specified, this option will locate selected directory 
files on a disk. You can use the global characters ? and * in the filename and 
extension parameters. For example: 


DISK filename. ext 


or 
DISk d:filename. ext 


Examples _ To list on the printer the names of all the files on the entire disk, 
enter: 


DISK/W >LPT1: 
To include in the list the hidden files: 
DISK/W/H >LPT1: 


To locate all files with a file extension of BAT, listing full file information 
with attributes, subtotals and totals, as well as automatic pause at a full screen, 
enter: 


DISK/F/T/P * BAT 


To list the names of all directories, enter: 


DISK/D/W 

To see the actual structure, sort the complete directory names with the com- 
mand: 
DISK/D/C | SORT 


To list the space used by each directory: 
DISK/F/T/W | FIND "-- -” 
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To list all files with extension OLD and list the space needed as a result of 
placing them on the disk in drive A, type: 


DISK/W/RA *.OLD 


Problem: I want to do the same thing with a whole group of files located in many 
different directories. I will want to selectively eliminate some of the files from 
the action. 


Example: First build an output file called GROUP.BAT of the names of all files 
that start with either the letter X or Y and have an extension of DAT. Display the 
count of the total number of files that qualify. 


DISK/T/B = X*.DAT > GROUP.BAT 
DISK/T/B) = Y*.DAT > GROUP.BAT 


You may optionally edit the file GROUP.BAT to eliminate the files you do 
not want. Then execute the batch procedure file just constructed. The two 
dummy replaceable parameters allow the batch procedure file to perform most 
any action desired. To copy all the files to drive A, type: 


GROUP COPY A:*.* 

To erase all the files: 
GROUP ERASE 

To change the extension on all the files: 
GROUP RENAME *.BAK 


Author/Source Copyright© February 1985, MJH Consulting. Permission 
granted to copy for non-commercial uses only. All other rights retained. If you 
find this software useful, send a donation to: MJH Consulting, 312 Schulte NW, 
Albuquerque, NM 87107. 
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DS. EXE 


Purpose An excellent DOS directory and command shell. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features DS.EXE is perhaps the best DOS directory and com- 
mand shell available in the public domain. A shell is a program that simplifies 
and streamlines DOS operations. The functions and features of DS (Directory 
Scanner) are documented below: 


Directory Movement 


The Function Keys F1 thru F8 allow the user to move the directory high- 
lighter from one directory to another. Moving the highlighter from directory to 
directory does not change the user into the newly highlighted directory until the 
user strikes the carriage return key. The directory function keys do the following: 


Fl - Move the directory highlighter backward/up to the previous directory. 

F2 - Move the directory highlighter forward/down to the next directory. 

F3 - Move the directory highlighter to the root directory. 

F4 - Move the directory highlighter to the very last directory. 

FS - Move the directory highlighter to the directory displayed at the top of the 
display screen. 

F6 - Move the directory highlighter to the directory displayed at the bottom of 
the display screen. 

F7 - Scroll up the display of the directory structure. 

F8 - Scroll down the display of the directory structure. 


(Remember, you need to hit the carriage return to change/enter a directory.) 


Currently there is a limitation of a maximum of 100 directories for any one 
drive. Exceeding this limit will result in an error message. See “‘Ctrl-L” option. 


File Indicator Movement 

Upon entering a directory that contains one or more files, the first file in the 
directory is marked with two small triangular indicators, one on each side of the 
file name. This indicates which file is the current “indicated file,’ and additional 
file information is displayed at the bottom of the display screen. 
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To change the ‘‘indicated file” the file indicators are moved from file to file 
through the use of the cursor arrow keys on the numeric keypad. The arrow and 
related keys work as follows: 


Up Arrow Key — - Move to the previous file 

Down Arrow Key - Move to the next file 

Left Arrow Key ~- Move to the file in the column to the left 
Right Arrow Key - Move to the file in the column to the right 


Home Key - Move to the first file on the display screen 
End Key - Move to the last file on the display screen 
PgUp Key - Display previous page of file names 

PgDn Key - Display next page of file names 


The PgUp/PgDn keys are active only when the currently displayed directory 
has more files than can fit on a single screen/page. 

Currently there is a limitation of a maximum of 250 files per any one direc- 
tory. Exceeding this limit will result in an error message. See “‘Ctrl-L” option. 


Commands 


Attribute Tagged Files (Option ‘‘A’’). This option allows the user to change 
three of the attribute bits on all files that are tagged. Depressing “‘A’” with no files 
tagged will result in an error beep. Once files have been tagged this option 
becomes available. Activation of this option will allow the user to turn on/off the 
read-only bit, the system bit and the hidden bit, by toggling the “r”, “s”’, and 
“h’”” keys respectively. Changing the file’s attribute bits only takes effect when 
the carriage return key is depressed. The user should toggle the attribute select 
keys (‘‘r’, “‘s”, and ‘‘h’’) to the desired states, then hit the carriage return to acti- 
vate the desired changes. 

Attribute Directory (Option ‘‘CTRL-A’’). This option allows the user to 
change the same three file attribute bits that Option A (above) changes, except 
that this option works on the attribute bits of the highlighted directory. The sig- 
nificance of changing the read-only or system bits of a directory is unknown. 
Turning the hidden bit of a directory on will hide the directory from the normal 
DOS “dir” command. The DS program can see the directory regardless of the 
condition of the hidden bit. The user may want to hide a directory so that other 
people that use the same machine do not rummage through the hidden directory. 
This assumes the other users do not know or have access to the DS or other pro- 
grams that show the directory regardless of the hidden bit. The user is prohibited 
from changing the attribute bits on the root directory of any drive. All sub-direc- 
tories are fair game. 
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Backup (Option ‘‘B’’). The backup option will execute the “‘ds_bkup.exe”’ 
program. It will prompt the user for the type of backup (ie: to floppy disks or to a 
second hard disk) and the backup drive destination. It will then present a display 
screen identical to the main DS program with the exception that the ‘indicated 
file’ is now marked with only a trailing indicator. All files displayed will have 
one of three characters preceding the filename. The three characters and their 
significance are: 


‘+ °° indicates the file has its archive bit set, or that the user would like to set the 
archive bit on. 

[sp] indicates the file does not have the archive bit set, or that the user would 
like to clear the archive bit. 

‘‘.”? indicates that the user would like to delete this file. 


In the manual mode, the user is presented with the opportunity to modify the 
archive bit of a file by changing the character preceding the file name. The actual 
changes to the file’s archive bit are not implemented until the user processes his/ 
her desired changes by hitting the “p” key. The “‘p”’ key processes changes and 
will set/clear the archive bit on files with ‘+ ’’/[sp] respectively, and delete those 
files marked with a “-”’ preceding the file name. 

The actual backup (copying to backup) is done only on those files that have 
their archive bit set on. In the manual mode, the backup of a directory is accom- 
plished by the user pressing the “‘x”’ key. The “‘x”’ key will eXecute the backup of 
a directory. If there are no files in the selected directory that need backing up (ie: 
no files have their archive bits set) then pressing “*x”’ will appear to do nothing, 
and you are left in the same directory to choose additional options. If the direc- 
tory does need backing up, then the backup procedure will commence; and if the 
backup is to floppy disks, the user will be prompted to enter the appropriate 
backup diskettes. 

The auto/manual mode refers to the capability of moving from directory to 
directory manually or automatically. In the manual mode, the user must move 
from one directory to the next through the use of the F1-F8 keys and the carriage 
return. In the auto mode, the backup program automatically moves on to the next 
directory after it has completed operations in a given directory. The user may 
switch back and forth from the manual mode and auto mode through the use of 
the “‘m” and “a” keys. To enter the auto mode from the manual mode simply 
depress the ‘“‘a” key. To enter the manual mode from the auto mode simply 
depress the “‘m”’ key. 

In the auto mode, if a directory requires backup and the user is backing up to 
floppy disks, the user is prompted for inserting the proper backup disks. If the 
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user does not desire to back up the currently displayed directory, the user may 
skip that directory by depressing the Esc key. The program will then move on to 
the next directory and check for required backups. The user is automatically 
placed in the manual mode at the completion of the auto mode (ie: when the auto 
mode has completed processing the last directory). Auto mode backup to another 
hard disk does not require prompting for backup disks; however, the user may 
still be prompted for possible obsolete backup files (see below). Auto mode 
backup to another hard disk requires the destination directory have the same full 
pathname as the source directory with the exception of the drive ID (ie: 1st char- 
acter). 

The backup program maintains three user selectable copy options. They are: 


1) Precautionary Copy - A precautionary copy is the copy to backup of a file 
which did not have its archive bit set. The file is copied to backup even though 
the archive bit was not on as a precaution because the backup program could 
not find a file by the same name on any of the backup disks for the current 
directory. The default for this option on start-up is NO (do not do precaution- 
ary copying of files). For this option to work correctly, the user must insert all 
backup disks for a particular directory in the correct sequential order and 
answer Yes to the prompt on the final backup disk. 

Obsolete Backups - An obsolete backup file is a file the program finds on a 
backup disk, and for which it does not find a file by the same name in the 
directory that the user is backing up. The default for this option on start-up is 
‘identify’ possible obsolete files. 

Delete Duplicate Backups - Duplicate backups are two files on two different 
backup floppy diskettes of one directory that have the same name. The default 
for this option on start-up is NO, do not delete duplicate backup files. For this 
option to work correctly, the user must insert all backup disks for a particular 
directory in the correct sequential order and answer Yes to the prompt on the 
final backup disk. 


2 


~~ 


3 


’ 


All three of the above copy options can be changed by the user by selecting 
the ‘“‘d” (for defaults) key, and then toggling either the ‘“‘p’’, “o”’ or “d” keys for 
Precautionary Copy, Obsolete Backups, and Duplicate Backups respectively. 

One of the options available while in the manual mode is the “‘Restore-.bat”’ 
option. This option will construct, in the root directory of the drive to be backed 
up, two batch files that can be used to reconstruct the directory structure and 
restore all backup files, if the need to reformat the hard disk becomes necessary, 
or if the user desires to switch over to a new hard disk. If you are backing up to 
floppies, the two files are ‘‘ds_fl.bat” and “‘ds_f2.bat”. If you are backing up to 
a second hard disk, the files are ‘“ds_h1.bat”’ and ‘“‘ds_h2.bat’’. This option 
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should be executed each time the user makes some sort of change to the directory 
structure (ie:mkdir/rmdir) on the hard disk in question. 

It is MANDATORY that ‘‘ds_drive.sys”’ be installed at boot time. 

Command Enter (Option ‘‘C’’). The command entry option allows the user 
to enter any command they would enter at the normal DOS command prompt. 
Whatever is entered by the user is passed on to a second copy of ‘‘command 
.com’’. Upon completion of the command, the DS program resumes. This option 
allows the user to start up a second command processor by issuing the command 
‘“‘command.”’ To terminate the second command processor, the “‘exit’” command 
would be given. 

Copy Tagged Files (Option ‘‘Alt-C’’). The copy tagged files option will copy 
those files that are tagged (see Option “‘T”’ below) to a specified directory. The 
user will specify the desired destination directory. If the user desires to make a 
second copy of a file in the same directory, specify only the new name of the file. 
If the user specifies only a drive specification such as ‘“a:’’, the program will 
copy the tagged files to the current directory on that drive. If the user does not 
specify a destination directory but simply enters a carriage return, the program 
will copy the tagged files to the directory which is currently highlighted. When 
choosing this last method of specifying the destination directory, prior to entering 
the carriage return the user may change the highlighted directory with the use of 
the Fl thru F8 keys. The program will not allow the user to copy a file or files to 
the same directory without specifying a new filename. In other words, no copy 
will take place if the user simply enters a carriage return and the highlighted 
directory also happens to be the current directory. This prevents the system from 
trying to copy a file onto itself and consequently clobbering itself. 

Drive Change (Option ‘‘D’’). The drive change option allows the user to 
switch to a different default drive and display the directory structure information 
of the new drive. When switching off a hard disk, all directory structure informa- 
tion about that drive and other pertinent program information (ie: current colors) 
is first copied to the device driver “‘ds_drive.sys”” memory location. This is done 
so that, when switching back to that hard disk, it is not necessary to do the 
lengthy disk I/O process to recover the disk directory structure information. 

Delete Tagged Files (Option ‘“‘Alt-D’’). The delete tagged files option will 
allow the user to delete those files that have been tagged (see Option “T”’ below). 
This option will first request a confirmation that the user really wants to delete all 
those files marked. The default confirmation response is ““Y’’ so depressing any 
key except ““N”’ (and Esc) will delete all tagged files. 

Directory Add/Delete/Change (Option ‘‘Ctrl-D’’). The directory modifica- 
tion option will allow the user to add or delete directories, and also to change the 
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name of specified directories. Once the option is selected, the three sub-options 
are displayed. If the user desires to delete or change the name of a directory, the 
specified directory must be highlighted thru the use of the F1-F8 keys. If the user 
desires to add a directory, the PARENT directory of the new directory must be 
highlighted. Some additional constraints on each sub-option are: 

Add Directory: 


1) The addition is denied if the current number of directories is already at the 
max directory limit. 

2) The new directory name must be valid. 

3) The new directory name must have a full pathname and screen print name 
each less than 40 characters. 

4) The addition is denied if the addition would exceed the space allowed for sav- 
ing drive info in the DS_DRIVE.SYS driver. (see Ctrl-L) 


Delete Directory: 


1) Deletion is denied if the user is currently in the specified directory (ie: right 
side file display matches left side highlighted directory). 

2) Deletion is denied if the highlighted directory is not empty (ie: has subdirec- 
tories or files still attached). 

3) Deletion is denied if the highlighted directory is the root directory. 


Change Name: 


1) The new directory name must be valid. 

2) The new directory name must have a full pathname and screen print name 
each less than 40 characters. 

3) The change is denied if the change would exceed the space allowed for saving 
drive info in the DS_DRIVE.SYS driver. (see Ctrl-L) 

4) The change is denied if the change would cause an increase in the full path- 
names of subdirectories which would exceed the space allowed for saving 
drive info in the DS_DRIVE.SYS driver. 

5) Based on limited testing to date by the author, the change name option only 
appears to work on PC/MS-DOS 3.0+. Apparently DOS 2.x does not sup- 
port changing of directory names. More investigation on this issue will be 
done for future releases. 


Upon completion of a valid add/delete/change, the program will adjust the 
directory tree display and allow the user to make additional add/delete/changes. 
To terminate the directory modification option, hit the Esc key. 

Edit Indicated File (Option ‘‘E’’). The edit option will allow the user to edit 
the current ‘‘indicated file.’ The user must have a file (your favorite editor) by the 
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name of “‘edit.com” or “edit.exe’’ in your PATH. The DS program does not pro- 
vide an editor, but simply attempts to execute a .com or .exe file by the name of 
“edit” and if successful, passes to it the name of the current indicated file. Upon 
termination of the editing process, the DS program resumes where it left off. It is 
highly recommended that the user obtain and execute the ‘““DPATH” program 
(found on most RBBS boards) in their autoexec.bat file. DPATH is to data files 
what PATH is to executable files. With DPATH in effect, your editor will be able 
to find all its support files even though the current directory might not be the 
directory where your editor and the support files reside. 

Find File (Option ‘‘F’’). The find option will allow the user to search the 
current default drive for a specified file. The user provides the name of the file, 
which can include the ‘‘*’’ and “?” wildcard specifiers. The find option will then 
commence a search of all directories starting from the root directory. When a 
matching file is found in a directory, the program stops in that directory and dis- 
plays the files of that directory. Additionally, the matching file will become the 
current “‘indicated file.” This option only finds the first matching file in the 
directory. If there are additional files that match (which is likely with “*’’ and 
‘*?’?) in the same directory, the user must spot these additional files. Additionally, 
the first matching ‘“‘indicated file’’ might not be listed alphabetically first. 

Once the program has halted in a directory that has a matching file, then the 
“L” or ‘‘1” key will list the indicated file. 

Note: Directory movement keys F1-F8 do not work here, but the arrow, 
Home, End, PgUp and PgDn keys do. 

The user has three additional options to continue/terminate: 


Esc Key - Continue searching directories 

F9 Key - Terminate search option in the currently displayed directory. 

F10 Key- Terminate search option in the directory from which the search option 
was started. 


If Esc is chosen, upon completion of the final directory the user is placed in 
the original directory from which the find option was activated. 

Note: The find option disregards the user’s current select & sort options (see 
Alt-S) while searching for matching files. During execution, the find option uses 
a select of “‘*.*’’ and a sort of filename ascending. Therefore, a display of direc- 
tories which contain matching files may be different and contain more files than 
the user is expecting to see. Upon termination of this option, the user’s original 
select & sort options are in effect. If, however, the user exits this option through 
the use of the F9 (current directory) key, the select/sort options are as desired but 
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the file display is left as the find option displayed it with “*.*” in ascending 
filename order. 


Free on Other Drive (Option ‘‘Alt-F’’). This option will allow the user to 
find out the available space (free bytes) of any drive without having to switch off 
the current drive. This option would most appropriately be used when tagging 
files on the current drive to copy to another drive. In this way, the user can get a 
rough estimate as to how many files can be tagged and copied to the other drive. 
The number of free bytes on the other drive will be displayed in the lower right 
corner of the box border, just above the display of the number of bytes tagged on 
the current drive. Due to the nature of file space allocation by DOS (in clusters of 
varying sizes on different media), you will not be able to copy as many bytes 
from one media to the other media as specified in this option. In other words, 
expect to copy fewer than the number of free bytes displayed by this option. 

Help Menu (Option ‘‘?’’). The help menu will print a one-page summary of 
all available options. 

List File (Option ‘‘L’’). The list option will allow the user to list the contents 
of the current “indicated file.’ The user should have a file (your favorite lister 
program) by the name of “‘list.com” or “‘list.exe” in your path. If neither file is 
found in the path, the indicated file will be listed via the DOS “type” command. 
An outstanding lister program by Vernon D. Buerg is available in the “‘share- 
ware” environment which is highly recommended for your use. 

Limits of the Program (Option ‘‘Ctrl-L’’). This option will show the user the 
limits of the current ‘“‘DS.EXE”’ program and its supporting ““DS_DRIVE.SYS” 
device driver. Normally the user should never need to exercise this option. How- 
ever, if one of the program limits is exceeded, an alarm will sound and a message 
will be displayed that states ‘Exceeded Program Limits.” The user can then use 
this option to determine which program limit was exceeded. Hopefully the pro- 
gram will continue to operate, disregarding the directories or files that exceeded 
the program limits. Because the size of the data structures supporting this pro- 
gram are determined at compile time (vice execution time), currently the only 
remedy for exceeding the program limits is to either rearrange your directory/file 
structure to conform to the program limits, or contact the author for another copy 
of the program with limits extended to values more appropriate to your particular 
system. 

Move Tagged Files (Option ‘‘M’’). The move tagged files option allows the 
user to move those files tagged (see Option ‘‘T” below) to another directory on 
the SAME drive. Moving files from directory to directory is quicker and more 
efficient than copying all the tagged files to the destination directory and then 
deleting all the same files from the source directory. The user can either specify 
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the desired destination directory, or simply enter a carriage return. If the user 
enters only a carriage return, the program will move all the tagged files to the 
directory which is currently highlighted. When choosing this method of specify- 
ing the destination directory, the user may change the highlighted directory with 
the Fl through F8 keys prior to entering the carriage return. Additionally, the 
highlighted directory must be different from the current directory (the one hold- 
ing the tagged files for this method of entering only a carriage return) to work. 

Print Tagged Files (Option ‘‘P’’). The print tagged files option allows the 
user to send to the print spooler a maximum of 10 tagged files. This option sim- 
ply sends to the standard DOS “print”? command the first 10 tagged files. Once 
sent to the print spooler, it is recommended that you exit the DS program com- 
pletely to enhance or increase the speed of printing the desired files. If the user 
remains in the DS program, the speed of printing the files is drastically reduced 
because the print spooler must compete with the DS program for cycle time. 

Rename File (Option ‘‘R’’). The rename option allows the user to rename 
the indicated file. 

Rescan Directory (Option ‘‘Alt-R’’). The directory rescan option will rescan 
the directory structure of the current default drive. This option may be necessary 
if you switch floppies in a floppy drive. It may also be used on a hard disk if you 
make or delete directories without using the directory modification (Ctrl-D) 
option. This option can be used in place of exiting the DS program and re-enter- 
ing it with “ds c” to rescan the “c”’ drive. 

Screen Refresh (Option ‘‘S’’). The screen refresh option will allow the user 
to redraw the entire screen. This might become necessary if a DOS message like 
“Abort, Retry or Ignore’’ disrupts the screen. 

Select & Sort (Option “‘Alt-S’’). The select & sort option allows the user to 
specify alternate sorts of the files in a directory. Additionally, it allows the user to 
filter out some files by allowing entry of a file match parameter to use rather than 
accepting the default file match parameter of “‘*.*”. Upon program initializa- 
tion, the defaults are a filter of ‘“*.*”’ with a sort by filename in ascending order. 

After selecting this option the user may change any/all the defaults. Depress- 
ing the space bar will toggle the sort option through the five sort types of no sort, 
name, extension, size and date. Depressing the up arrow or down arrow will tog- 
gle the sort direction to ascending or descending respectively. Entry of any other 
valid character will allow the user to change the file match parameter. Depressing 
the carriage return character after valid file filter parameter characters will 
change the file filter to the newly specified file filter. Depressing the carriage 
return character without any new file filter entered will change the file filter 
back. The new sort and file select filter takes effect upon termination of the sort/ 
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select option—upon pressing the Esc key. After terminating this option, the new 
sort option will be displayed on the 1st of the three bottom status lines, right after 
the “Help = ?” message. Additionally, if the file select filter is anything other 
than ‘“‘*.*”, it will be displayed above and slightly to the right of the sort type/ 
direction in the display border. : 

Tag File (Option ‘‘T’’). The tag file option is used as a precursor to other 
options such as the copy tagged files option. When this option is selected, the 
current indicated file is set to reverse video and the next file becomes the current 
indicated file. 

Tag All Files (Option ‘‘Alt-T’’). The tag all files option allows the user to tag 
all the files in the current directory in preparation for execution of another 
option. 

Untag Files (Option ‘‘U’’). The untag option allows the user to untag a file 
that has been tagged by mistake. 

Untag All Files (Option ‘‘Alt-U’’). The untag all files option allows the user 
to untag all the files that are currently tagged. 

Volume ID Toggle (Option ‘‘Ctrl-V’’). The volume ID toggle option will turn 
on/off the display of the default drive’s volume label. The volume ID will be dis- 
played in the lower left corner of the display border when available and turned 
on. The default on start-up is toggle OFF. 

Execute File (Option ‘‘X’’). The eXecute file option allows the user to exe- 
cute the current indicated file if its file name extension is ““.com”, “.exe”’, 
“ bat”, or “‘.bas”. Files with a .com or .exe extension are executed directly (ie: 
are not passed thru the command processor so no I/O redirection is possible). 
Files with a .bat extension are submitted to a secondary command processor. 
Files with a “.bas” extension are passed as a parameter to the execution of a file 
by the name of ‘‘basica.exe’’. Prior to the execution of any of these files, this 
option allows the user to enter command line arguments which are passed to the 
indicated program as it goes into execution. 

Execute File (Option ‘‘Alt-X’’). This eXecute file option is the same as the 
one above (X), but allows redirection of I/O as the indicated file, and its argu- 
ments are executed through the command processor. 


Color Changes 


The DS program will allow the user with a color/graphics monitor to change 
the color of the foreground, background and display border. The following keys 
are used: 


Grey “+” Key - Change/Increment the display foreground color. The fore- 
ground cycles through 16 colors. 
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Grey ‘“‘—” Key - Change/Increment the display background color. The back- 
ground cycles through 8 colors. 
Delete Key - Change/Increment the display border color. The border cycles 
through 8 colors. 


Color changes should be done while the default drive is a hard disk so that 
when switching drives the colors will be retained. The color information is writ- 
ten/retained in the device driver “‘ds_drive.sys’”» memory area when shifting off 
the hard disk. If the user exits DS and then activates it again, the old colors (from 
the previous session of DS) will be read from the “‘ds_drive.sys’’ memory area 
and used in the new session. 

The initial start-up colors of the DS display are determined in one of two 
ways. 

For the first method, the user specifies a “‘set DS=OF14”’ statement in the 
environment (most appropriately in the autoexec.bat file) prior to initial execu- 
tion of the program. The set statement will place the ‘DS’ variable into the envi- 
ronment for program access. The ‘DS’ variable is formatted as shown below in 
Fig. 4-1. 


DS= rFB b 


border color (0-7) Fig. 4-1. This illustrates 
the format of the DS 

Background color (0-7) variable. 

Foreground color (0-7) 

recursion level indicator (always 0) 


no spaces in variable definition 


Colors are specified as follows: 


0 = Black = Gray 

1 = Blue = Light Blue 

2 = Green A = Light Green 

3 = Cyan B = Light Cyan 

4= Red C = Light Red 

5 = Magenta D = Light Magenta 

6 = Brown E= Yellow 

7 = White F = High-intensity White 
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The easiest way to determine the correct parameters to enter with the “set 
DS-0xxx”’ command is to activate the program, cycle through the colors with 
‘+’ *—’ and Backspace until you have the colors you want, then depress the Ctrl 
and Home keys simultaneously. The ‘“‘Ctrl-Home”’ option will show you the cor- 
rect parameters to enter for the currently selected colors. 

For the second method: If the user does not place the ‘DS’ variable in the 
environment as described above, the foreground and background display colors 
will be the default colors in use at the time the DS program is initially executed. 
The border color is chosen by the program to ensure it does not conflict with the 
foreground or background colors. 

Upon exiting the DS program, the DOS default colors that were in use prior 
to the execution of DS are reactivated. Should the user desire to change the DOS 
default colors prior to exiting the DS program, the user can select the “Ctrl- 
End” option. The “Ctrl-End” option will allow the user to retain the current DS 
program colors upon returning to DOS. This option requires the ‘‘ansi.sys”’ 
device driver to have been installed at power-up. 

Exit Options. Two exit options are available: 


F9 ~- Exit in the directory that is currently highlighted. 
F10 - Exit in the directory from which the DS program was originally started. 


Author/Source LCDR Nat Martino, Pacific Missile Test Center, Point Mugu, 
CA 93042-5000. (805) 989-1390/1391. 
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DUPS.COM 


Purpose Finds all duplicate files on a drive. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features DUPS is an excellent tool for generating complete 
directory reports for an entire diskette or hard disk. When executed, a screen 
with four options is displayed. 

The first option generates a list of filenames which appeared in more than 
one directory, helping to highlight potentially unintentional duplication of files. 
The second option creates a sorted report of all files on the disk, regardless of 
location. The third option creates a “‘sorted tree” report, showing the entire disk 
directory structure. 

DOS users with hard disks will find this utility indispensable. 


Author/Source Karson W. Morrison, Caleb Computing Company, Rd. 1, 
Box 531, Ringoes, NJ 08551 (©) 1985. 
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LE.COM 


Purpose List files by extension. Useful with large directories. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features __LF is similar to the DOS DIR command except that 
files are grouped by their extensions. LF takes no options or parameters, only 
listing the contents of the current directory. LF is most helpful in dealing with 
large directories. 


Author/Source J. P. Garbers 
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LIST2DAY.COM 


Purpose Lists files created today — useful for making backups. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features LIST2DAY is a short utility program that lists all files 
in the default directory which were created today. The program assumes the date 
supplied at boot-up is correct and uses this date. This utility might be useful in 
determining which files to back up on a daily basis. To invoke the program, sim- 
ply type LIST2DAY. 


Author/Source Unknown 
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MDSECRET, CDSECRET 
and RDSECRET.COM 


Purpose Create hidden directories for program security. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features These three programs serve to lock-out sub-directories 
from access to all but the most determined user. By placing sensitive or confiden- 
tial files in a hidden directory, you can make it very difficult for an unauthorized 
user to access your private data. Hidden directories are not visible to the user 
when looking at the directory by issuing the DIR command. 

The technique involves creating a subdirectory which has the ASCII delete 
character (07Fh) as the first letter of the subdirectory’s name, followed by up to 7 
user-specified characters. MDSECRET (MakeDirectorySECRET) then sets the 
hidden flag for the directory entry through the DOS CHMOD function call. This 
is equivalent to the MKDIR command. 

The directory can only be set as the current directory by using CDSECRET 
(ChangeDirectorySECRET), which is equivalent to use of the DOS CHDIR 
command. The hidden directory can only be deleted through use of the RDSE- 
CRET (RemoveDirectorySECRET) command, equivalent to the DOS RMDIR 
command. 

This method is not completely impenetrable, however. Any super-directory 
program which shows hidden files will display the subdirectory names created 
through MDSECRET, and a determined user could then use the knowledge of 
the directory name to write a program which can access the subdirectory, in the 
same manner as CDSECRET and RDSECRET. Without such a program, the 
user will not even know the name of the subdirectory, or even that it exists. If the 
DELETE character were not included in the file, the user might try random 
names with the CHDIR command, eventually finding one and successfully 
accessing it. If one knows the name of the hidden sub-directory, it is just as 
accessible as a visible one. By including the DELETE character, however, the 
user will not be able to issue the CHDIR command from the keyboard for this 
sub-directory name. 


Author/Source Charles Incaprera 
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NUNAME.COM 


Purpose Rename subdirectories command. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features © NUNAME is the command Microsoft forgot to include 
with DOS—a directory rename command. This utility eliminates the need to 
destroy and recreate a directory simply to give it a new name. Format for the 
command is: 


NUNAME old-directory-name new-directory-name 
Directory names can include paths. 

Example 

NUNAME 123 LOTUS 


Author/Source Ian A. Webb, West Valley College, Saratoga, CA 95070. 
Based on an idea in PC World, Power User, p. 249, 2/11/86 by Michael 
Toutonghi, Seattle, WA. 
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PROTECT.COM 


Purpose Simulates a write-protect tab for your hard disk. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features PROTECT.COM is a utility designed to write-protect 
your hard disk drive in the same fashion that a write-protect tab does on a floppy 
diskette. To write-protect drive C:, type PROTECT at the DOS prompt. To 
switch off this feature, simply type PROTECT at the DOS prompt again. If you 
have another hard disk or RAM-disk installed, these will also be protected simul- 
taneously. Writing to drives A: or B: is unaffected by the program. PROTECT is 
a useful insurance policy against accidental “FORMAT C:” commands, Trojan 
programs, BBS hackers, and inexperienced users destroying your hard disk data. 


Author/Source Tom Kihlken 
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RSUBDIR.EXE 


Purpose Removes a subdirectory with all associated files as a single 
command. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features RSUBDIR serves to remove a subdirectory and all its 
files without first having to delete the files or sub-sub-directories within it. In 
addition, the file attribute is changed for all system, hidden, or read-only files so 
that they may be deleted as well. The command syntax is: 


RSUBDIR path 


where path is the path to the directory to be removed. If a drive letter is not speci- 
fied in the path, the default drive will be used. 


Example 
RSUBDIR A: \ DOS \ UTIL 
would remove the files of subdirectory UTIL and then erase subdirectory UTIL. 


Author/Source: Unknown 
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SST.COM 


Purpose Disk optimizer. Defragments files. 
Hardware _ Hard Disk. 
Software DOS 2.0 or later. 


Description/Features SST is a program that is designed to reorganize a DOS 
disk so disk access will be faster. Normal daily use of a disk will produce a disk 
with many fragmented files and subdirectories. These are files that are not com- 
pletely contiguous, but are spread out all over the disk. These fragmented files 
and subdirectories slow disk access down because DOS must tell the Disk Head 
to Seek to other parts of the disk to pick up other parts of the same file. For exam- 
ple, your disk might have three files on it that we will call A, B, and C. Different 
parts might be arranged as follows. 


AAAAAAABBBBBBBBAAAC CCAAABBBB CCC 


SST would reorganize the three files so that all of their parts would be contigu- 
ous. 


AAAAAAAAAAAAABBBBBBBBBBBBCCCCCC 


This change would shorten the amount of time that it takes DOS to read in 
the file. If a subdirectory is fragmented, fixing it will speed up disk access time 
even more noticeably! 


Syntax: SST [d:] [ TEST] [ CLEAR] 


TEST -_ will run SST in a READ-ONLY mode. No alterations will be made to 
the disk. 

CLEAR - will move all erased entries in all directories to the ends of those direc- 
tories. 


SST reads in all of the data that it will need during the run session and keeps 
this information in memory. Specifically, SST uses DOS Interrupts 25h and 26h 
to look at the boot track and other parts of the disk. Information about disk char- 
acteristics are stored there. SST makes a quick comparison of the data it gets here 
with what DOS thinks about the disk. If these two sets of data agree with each 
other, SST will read in the disk’s File Allocation Table, Root Directory and All 
subdirectories. All of this information is kept in memory during the SST session. 

SST then decides on the best way to reorganize the disk’s clusters. When this 
is finished, the user is prompted (Y or N) to continue or not. 
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A “Y” response to the above question will start the File Cluster Swapping 
procedure. Here, the actual file data is physically moved. All data is buffered in 
memory. When SST if finished swapping, it then updates the File Allocation 
Table on the disk, and all directories. 

Some disk optimization programs use the slower and safer method of buf- 
fering file data to the disk. While this practically eliminates the chances of data 
losses because of accidents such as power failures, it makes the program run very 
slow on a nearly full disk. 

It is strongly advised that the user back up their disk before using SST. 
Because SST buffers all Data, Tables, and Directories to Memory, if a power 
failure occurs while cluster swapping is in action... ALL DATA WILL BE 
LOST. The same thing goes for any interruption during the swap procedure. Sim- 
ply leave SST alone after pressing ““Y’’ when prompted! 

SST assumes that all disk sectors that are bad are so marked in the File Allo- 
cation Table. If you have a hard disk that causes you problems (it develops unex- 
pected bad Sectors regularly), don’t use SST on it unless you have verified that 
the disk is currently OK. One way of doing this is with Peter Norton’s DiskTest 
Program in his Norton Utilities Package. 

SST is intended for computer users who have the ability to quickly back up 
their disk, and who don’t have the time to waste for a simple disk optimization. 
Other disk optimizers can take many hours to work on a large/full disk. SST can 
usually handle these more quickly. For example, SST has reorganized a 32 MEG 
Hard disk on an AT compatible in under 30 minutes. This particular optimization 
moved over 20 Meg of data. 


SST Limitations SST is designed to run only in a single user, non-multi-task- 
ing system without TSR programs installed. SST can perform an optimization on 
almost any standard DOS disk up to 32 Megabytes in size—as long as sectors are 
512 bytes long. However, it should be noted that SST needs a lot of memory to 
work with bigger disks. If SST runs out of memory, a runtime error FF will halt 
the program. This error typically occurs while SST is reading in the subdirecto- 
ries, and before anything is moved or changed on the disk. SST’s memory alloca- 
tion routines will look to see if enough memory is available when the “BIG 
BYTES” are needed. A lack of memory returns a message along with the Run- 
time Error FF message. The smaller dynamic memory allocations are not pre- 
checked. 

If SST just can’t quite make it to the SWAPPING procedure with the mem- 
ory that you have, you can do a few things to try and get it to run. Simply do a 
cold boot without any unneeded device drivers in the system. Temporarily re- 
name your CONFIG.SYS file to something else and boot up without any of the 
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other DOS parameters that you might specify that use up memory (BUFFERS = 
##). SST does not use DOS’s disk buffers to move any disk cluster data. Don’t 
run any TSR programs before SST. 


Author/Source Copyright 1986, Alfred J. Heyman, Room 101, P.O. Box 
172101 Memphis, TN 38187. If you find SST to be useful, or you would like to 
be notified about getting possible future SST enhancements, you can become a 
registered SST user by sending $10 to the author. 
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TREEDIR.EXE 


Purpose Produces listings of all files by directory. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features This program combines TREE and DIR to produce a 
directory of all files in each directory along with date, time, and file size. The 
program is useful in displaying the actual space used on a hard disk for each 
directory, and the amount of space needed to copy to a diskette. Format for the 
command is: 


TREEDIR [directory] [/s] 
If the directory is omitted, the tree starts with the root directory. Use 
TREEDIR . 


to start from the current directory. If the /s option is specified, only the totals are 
displayed. 


Author/Source Alan Losoff, Milwaukee, Wisconsin. 
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WHAT.COM 


Purpose Annotate your files with a description. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features WHAT.COM is a handy utility that keeps notes about 
files on your system. At the DOS prompt, you can write a one-line description of 
any of your files. This comes in handy when you are looking at your hard disk 
directory three months later, and can’t remember what CRASH.COM does. 
Using WHAT.COM, you will be able to remind yourself with a quick little note. 

WHAT.COM is most useful for those with fixed drives, though it should 
work just fine with floppy drives. WHAT.COM creates a file in the root direc- 
tory called WHAT.DAT. This is just a sequential file containing the data for the 
program. Each entry starts in the first column with the filename. It must be in 
uppercase letters. WHAT.COM formats the file so it can be printed neatly, with 
columns for the filenames, and descriptions. Descriptions can be up to 60 char- 
acters long. That should be more than enough for a quick reminder of what a 
program does. 

Setting Up. First, you should initialize the WHAT.DAT file. This is done by 
giving the command: 


WHAT OPEN 


You will be asked if you want to create the file. If you answer ‘y’, a new 
WHAT.DAT file will be created. If there is already a WHAT.DAT file, it will be 
overwritten, and all the data will be lost. You should only use this command 
once. WHAT.DAT should not be edited with any word processor or unpredict- 
able results may occur. 

Next, you can start entering your program information. This is done by giv- 
ing the command: 


WHAT NEW filename. ext 


You will be asked to enter a 60-character description of the file. Enter any- 
thing you like. WHAT.COM will automatically include the name of the file, so 
you don’t have to re-enter it. (Hint: Enter only facts about the program, just 
enough so you will know what the file does, and perhaps how to get help with the 
program.) When you are done, press Enter, and WHAT.COM will ask if this is 
correct. You can enter ‘y’ if it is, and the data will be saved to the file. If you 
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enter ‘n’, WHAT.COM will ask for another description of the file. If you enter 
‘q’, WHAT.COM will stop, and the description will be lost. 
To find out what a file is, enter the command: 


WHAT IS filename. ext 


WHAT.COM will then search the DATA file for matching filenames. If 
WHAT.COM finds a filename that matches, it will print the description on the 
screen, then look for another match. If it does not find the filename, it will tell 
you that the file was not found. WHAT searches by comparing the characters that 
were entered at the keyboard, with the first characters on each line of the data 
file. If you enter: 


WHAT IS PROGRAM.COM 

WHAT will output the description for PROGRAM.COM. 
If you enter: 

WHAT IS PROG 


WHAT will output descriptions of all files starting with PROG. There might be a 
PROG.COM, or a PROGA.COM, or PROGRAM.COM. It will match the first 
characters on the data line with the filename. You could enter: 


WHAT IS Q 


and all descriptions of files starting with Q would be written to the screen. 

The last command you can give WHAT.COM is the print command. This 
will send the contents of the WHAT.DAT file to the printer. You might find it 
useful to have a printed copy of WHAT.DAT, in case you want to browse through 
the files. 

WHAT.DAT can be sorted with the DOS utility SORT. Best way to use it is 
to give the command: | 


SORT < WHAT.DAT >WHAT.DAT 


This will sort the file WHAT.DAT, then save the sorted list back in WHAT- 
.DAT. This way, when you print the WHAT.DAT file, it will be in order. 


Author/Source Kevin Ross 
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WHEREIS.EXE 


Purpose Search all directories for a specified file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features WHEREIS is a powerful directory searching utility 
which will display one or all occurrences of a filename or group of filenames at a 
specified directory level and downward. You will never have trouble finding 
“lost” files again. WHEREIS.EXE is invoked by typing WHEREIS filename. ext 
at the DOS command prompt. DOS wildcard characters may also be used in 
specifying filenames; if an extension is not specified, it defaults to wildcard: 


e WHEREIS TEST is the same as WHEREIS. * 
e WHEREIS TEST? may be used to find programs TEST1.BAT and TEST- 
2.BAT 


The program will search-for the specified program on all directories. When 
a matching filename is found, it will ask if you want more to be searched for. You 
can press “‘y”’ or ““Y”’ to search for more files, or any other key to terminate the 
program. This prevents thrashing around on the disk looking for more matches, 
when the user already knows there aren’t any. 

You can supply a ““G” switch to force all matches to be printed without the 
““more’”’ query: 


WHEREIS TEST1 /G or whereis testi /g 


If no filename is supplied on the input line, the program will give an error mes- 
sage. 

It is best to put this utility program in one of the directories pointed to by a 
PATH command so that it is always available no matter where you are working. 
For instance, if you have WHEREIS.EXE in the subdirectory SYSTEM on drive 
C, put the following line in your AOUTOEXEC.BAT file: 


PATH =C: \ SYSTEM 
Author/Source John Socha, Softalk/PC 
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Commercial Disk Maintenance Utilities 


DISK OPTIMIZER 
SoftLogic Solutions, Inc. 
One Perimeter Rd 
Manchester, NH 03103 
(800) 272-9900 


This program analyzes your hard disk files to determine the extent of 
fragmentation. When DOS stores your files on disk, they are often broken into 
fragments. Data files, overlays, programs, and batch files that started out as one 
seamless piece become scattered all over the disk. This results in slower loading, 
sorting, retrieving, and backing up because the disk drive has to work harder to 
piece together your files. 

Disk Optimizer then finds all the scattered pieces of your files and puts them 
back together into continuous files. This might reduce time to read and write to 
the disk by as much as two-thirds. It may also reduce wear and tear on your disk 
drive. The program detects bad sectors on disk and seals these off from future 
access. One can select where files are placed on the disk to further optimize disk 
access. Password security may be added to files if desired. 

The shareware program SST.COM performs most of the same optimization 
functions, although it lacks the additional features listed above. It optimizes disks 
faster than this commercial utility, but has the disadvantage of resulting in com- 
plete data loss if there is a power failure during the optimization process. If this is 
a concern, you could back up your hard disk just prior to optimization as an 
insurance policy against power failure. Further documentation is available in this 
chapter under SST.COM. 
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Commercial Backup Utilities 


BACKUP MASTER 
Intersecting Concepts, Inc. 
4573 Heatherglen Court 
Moorpark, CA 93021 


Backup Master was the fastest hard disk backup utility tested, exceeding the 
speed of FASTBACK (TM), DSBACKUP+ (TM), BACKIT (TM), and INTEL- 
LIGENT BACKUP (TM). The program uses your computer’s DMA controller 
in a multitasking mode and formats diskettes using a proprietary technique. The 
special format increases the data storage per diskette and backup speed. One has 
the option of using standard formatting to back up files to another path, hard 
disk, or other device. The program can run two floppy drives continuously while 
the user is prompted to alternately insert backup diskettes. Complete file selec- 
tion options are included for selective backups. 
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CAL.COM 


Purpose Displays a calendar for the month specified. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features CAL is a handy utility for displaying a calendar for a 
specified month and year. This can be useful to check which day of the week a 
particular date falls on, and in routine planning. The syntax for the command is: 


CAL mmm yy 


where mmm = three letter abbreviation for month 
yy = two digit abbreviation for year 


Example 


CAL DEC 89 or cal dec 89 


Typing CAL alone produces a calendar for the current month by automati- 
cally reading the month and year from DOS. 


Author/Source Unknown 
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CLKCGA.COM and CLKMONO.COM 


Purpose Displays a digital clock in the upper right corner of the screen. 
Hardware CGA or IBM monochrome display adapter. 
Software DOS 2.0 or later. 


Description/Features These two utilities provide a continuously-running 24- 
hour digital clock display in the upper right corner of the screen. CLKCGA is 
designed for use on a CGA (color graphics) adapter and CLKMONO is designed 
for use on an IBM monochrome adapter. Time is displayed in the HOUR:MIN- 
UTE:SECOND format and occupies the last 9 characters in row zero. The clocks 
are activated by typing the program name and the DOS prompt, and will remain 
in place until explicitly deactivated by typing the program name once again. 
These programs are good candidates for inclusion in your AUTOEXEC.BAT 
file. 


Author/Source Joel Stanford 
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REMIND.COM 


Purpose Clock with alarm that pops-up as a reminder. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features REMIND may be used as a continuous display clock, 
or as a pop-up alarm/reminder. To use the program as a clock which continually 
displays the time in HH:MM:SS format in the upper right corner of the screen, 
type REMIND at the DOS prompt and answer “‘Y”’ to the first question (lower- 
case “‘y”’ or “‘n” is not accepted). To use the program as a reminder, follow the 
instructions as given by the program to enter a description and time. At the 
appointed time, a box containing the description will pop-up over your applica- 


tion and disappear within a few seconds. 


Author/Source Walter Stovall 
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THREECAL.COM 


Purpose Displays a calendar for the current, previous, and next month. 
Hardware No Special requirement. 
Software DOS 2,0 or later. 


Description/Features THREECAL reads the date as set by DOS to automati- 
cally display a calendar for the current, previous, and next month. 


Author/Source Unknown 
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6 
Programming, Debugging 
and Diagnostic Utilities , 


THIS CHAPTER describes utilities that allow access to individual bytes on a 
disk or file, provide programming shortcuts, and diagnose hardware problems. 
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CORELOOK.COM 


Purpose Examine memory contents. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _CORELOOK is a program similar to DEBUG and use- 
ful in displaying the contents of memory in HEX and ASCII format. Although 
the program may not be used to edit memory like DEBUG, it has the advantage 
of being fast and easy to use. The program has an efficient search capability to 
find a given address or ASCII string. 


Author/Source — B. Soucie 
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CPU.COM 


Purpose Checks the speed of your CPU. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features This program might be of use to those who have dual 
speed “turbo” motherboards to check the current speed of the CPU. To run the 
program, simply type CPU at the DOS prompt. The effective CPU speed will 
appear within a few seconds. 


Example 

A>CPU 

CLOCK SPEED CHECKER (minimal RAM access), please wait... 
Execution time should be 10.00 secs if 4.77 MHz clock and no 
WAITS on RAM access 


Actual execution time here was 06.05 seconds 
Effective clock speed = 7.88 MHz 


Author/Source Unknown 
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FM.COM 


Purpose _ File patching utility. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features FM (for File Modify) is a utility which allows you to 
easily edit files at the individual byte level. It is especially useful in situations 
where one might use DEBUG to modify a byte in order to patch a program, to 
change the wording of messages in your programs which bother you (its search 
capabilities are useful for this), or to change color attributes in a program. 

The program is invoked by typing 


FM filespec 


If filespec is of the form NAME.EXT, the program with that name in the 
current drive and directory will be loaded. FM supports other drives and full 
path names, so if your default drive is A: and FM.COM is on the current drive or 
in the DOS search path, the command FM B: \ some directory \ some filename 
will work perfectly. 

Keystroke Commands. A description of the most important keystrokes is dis- 
played on the FM screen, and the others are described in the help screen. The 
commands involve the function keys, cursor keypad, Tab and Escape. 

The function keys have the following meanings: 


Fl Help 

F2 Search 

F3 NOT USED 

F4 NOT USED 

F5 Hex/Decimal toggle 

F6 ASCII display toggle 

F7 NOT USED 

F8 NOT USED 

F9 Sector Save 

F10 Sector Jump 

Escape exits the program 

Tab toggles the active cursor between 
the HEX and ASCII areas 

cursor arrow keys_ do the obvious things 

PgDn reads the next sector 

Ctrl-PgDn pages down 5 sectors 
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Home moves the cursor to the start of the current line or, if already 
at the beginning of a line, moves the cursor to the beginning 
of the sector 

End moves the cursor to the end of the line/sector. 


The FM Display. FM displays the file in ‘“‘sectors” of 256 bytes each in 16 
lines with 16 bytes per line. The line below the main display shows the file name, 
its date and time of creation or last update and the word HEX or ASCII indicating 
which part of the main display is active. The TAB key toggles which is the active 
display and, in addition to a status line, the active display is indicated by the 
block cursor. Modifications are made on the active display as will be explained. 

The first column of numbers in the active display labels the lines by indica- 
ting the number of the first byte on the line. In the default mode the numbers are 
in hexadecimal and appear in angle brackets. 

The F5 key toggles to a decimal numbering of the lines. The next 16 columns 
of data show the HEX value of each byte—the 256 possibilities for a byte corre- 
sponding to two HEX digits. The next “‘column”’ gives the current sector number 
within the file and the number of sectors. In default mode, these numbers are 
given in HEX, but F5 toggles not only the line numbers, but also whether these 
numbers are given in HEX or decimal. This same column also reports the cur- 
rent value of the FS HEX/decimal toggle. 

The right hand columns show the individual lines in ASCII form. In the 
default mode, only “‘text characters” are shown with all non-text characters 
(ASCII numbers 0-31;129-256) indicated by periods. F6 toggles to and from a 
mode where these characters are shown. 

A help screen is displayed if one hits F2. Use the cursor control keys to 
scroll or page the help text. Pressing F1 again or pressing Escape will exit the 
help screen. 

Maneuvering. The PgDn and PgUp keys read the next and previous sectors. 
Depressing the Ctrl key while hitting these keys makes a change of five sectors. If 
the F10 key is depressed, you are prompted for a new sector number. Responding 
Enter will move you to the first sector (thus, because unsuccessful searches will 
leave you in the last sector, you’!l probably want to follow an unsuccessful search 
by the F10, Enter combination). Otherwise, a number should be entered and the 
program will jump to the appropriate sector. If line numbers, etcetera are dis- 
played in HEX, the sector number should be entered in HEX. 

Modifying. The whole point of FM is to change the file. In the default mode, 
the block cursor is in the ASCII part of the screen. The cursor can be moved with 
the arrow, Home and End keys. If a text character is struck, the character at the 
cursor is replaced by the character struck. The Tab key toggles to the HEX dis- 
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play. Modification of the two HEX digit bytes under the cursor is made by strik- 
ing the appropriate keys. Even if only one of the two digits needs to be changed, 
you must enter both of them. If you have entered the first digit, it will change on 
the display and flash until the second digit is entered. If any key other than 0-9 or 
a-e is struck, the byte returns to its initial value. 

Any changes made are indicated on both the HEX and ASCII display, but 
they are only made in memory and NOT on the original file. To make the 
changes in the original file, you must hit the F9 key. F9 only saves the changes 
made in the currently active sector, and not any changes made previously in other 
sectors. If you try to exit the program or change the sector shown, and you have 
made any unsaved changes, you are prompted to hit F9 to save the changes if you 
wish. 

Searching. You can do a rudimentary search through the entire file FOL- 
LOWING the cursor (not just the current sector). Hitting the F2 key prompts for 
a search string. ASCII search strings will be searched regardless of whether the 
current active mode is ASCII or HEX. To do a HEX search, precede the byte 
with a “_”. Do not place quotes around _ or around search text. You can search 
for multiple HEX bytes (so _41_61 will search for Aa) and ASCII and HEX can 
be mixed in the search string (so A_42C_44 will search for ABCD). 

Modifying FM. One of the uses of FM is to modify itself if you wish to 
change some of the defaults in the program. The twelve defaults which can be 
changed occur in sectors one (the first eight below) and three in the form relevant 
byte —function. Thus, to change the color attribute for the ASCII text display, 
find the string ASCII. The byte immediately preceding it is 2D(hex) for — and 
the byte before that (which is 07 for grey on black) can be modified to change the 
display color. For example, changing it to 1E will make that display as yellow on 
blue (on a color monitor). The color code is the standard one set by IBM (but 
different from the BASIC and ANSI.SYS color codes), namely: 


0 black 4 red 


1 blue 5 magenta 
2 green 6 brown (yellow) 
3 cyan 7 grey (white) 


Adding 8(Hex) to these for the foreground color produces their “‘intense”’ 
version; intense brown is yellow and intense grey is white. Adding 8 (Hex) to the 
background color causes the foreground to flash. The first HEX digit determines 
the background and the second the foreground. As indicated 1E (E=6+8 Hex) is 
yellow on blue while 9E would be flashing yellow on blue. 
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Here are the attributes which can be modified: 

LINE# Color attributes for line number; default is 04=red on black HEX 
Color attributes for the HEX display; default is 06 = brown on black 

HEXED Color attribute for the one changed HEX digit when editing in 
HEX mode and only one digit has been changed; default is FO = flashing black on 
white 

ACTIVE CURSOR Color attributes of the active cursor; default is 
70= black on white. 

PASSIVE CURSOR Color attributes of the position of the cursor on the 
inactive screen (shadow cursor); default is 01 = blue on black 

HELP SCREEN Color attributes of Help Screen; default is 74 = red on white 

HELP BORDER Color attributes of Help Border; default is 1C = intense red 
on blue 

BOOT MODE The default is 00 which causes the ASCII screen to be the 
active one when the program is loaded. Change it to 01 to make the HEX screen 
active upon program loading. 

BOOT DSTYLE The default is 00 which causes the line numbers, etc. to 
appear in HEX upon loading. Change to 01 to make decimal used upon loading. 

GRAPHICS The default is 00 which causes only text characters to be dis- 
played in the ASCII display when the program is loaded. Change to 01 to make 
all characters display upon loading. 

HEXID The ASCII character used in a search string to preface a HEX speci- 
fication. The default is _ which has an ASCII code of SF. To change _ to $ for 
example change 5F to 24. 

The three items preceding HEXID concern the initial settings of the choices 
controlled by the Tab, F5 and F6 toggles. Some of the default attribute settings 
are chosen so the display is useful on a monochrome monitor and you may wish 
to change them if you run FM from a color monitor. | 


Author/Source 
Doug Schafer Barry Simon 
Caltech 158-79 Caltech 253-37 


Pasadena, CA 91125 Pasadena, CA 91125 
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HDDIAGS.COM 


Purpose Hard disk diagnostic routines. 
Hardware IBM PC/XT/AT or compatible. 
Software DOS 2.0 or later. 


Description/Features This program is menu driven and in most cases should 
be self-explanatory. The diagnostics are divided into two categories, destructive 
and non-destructive tests. These tests can be useful in installing a new disk, find- 
ing and flagging bad data areas or testing the general working condition of your 
hard disk and controller. 

Non-Destructive Tests. In an IBM compatible hard disk BIOS, the last cylin- 
der is reserved for running diagnostic tests. This program uses that cylinder for 
diagnostic writes. 

F1—WRITE/READ/VERIFY TEST _ This test verifies that read and 
write work by writing one sector, then reading it and comparing it to the value it 
wrote. 

F2—SEEK TEST _ This test first verifies every cylinder and then exer- 
cises the read/write heads by performing a cross seek pattern. 

F3—HEAD SELECT This test selects one head on every cylinder. 

F4—ECC TEST Most controllers have some form of onboard error cor- 
rection that writes four bytes of ECC data with every data record. When the data 
is read, these four bytes of ECC are used to determine the validity of the data and 
make corrections for any incorrect bits depending on the controller. This test 
does a read long, modifies four bits, and writes the record back with a write long. 
The next read should return the corrected data. 

F5—RUN ALLTESTS This runs tests 1 through 4 and allows the user to 
loop up the tests. 

F6—PREPARE FOR RELOCATION Moves the read/write heads to the 
landing zone. The computer should be shut off after executing this or the heads 
will move back onto the data surface. 

F7—DEFECT SCAN _ Reads every sector the specified number of times 
and reports the errors. 


Destructive Tests. 

F8—SURFACE ANALYSIS _ This test writes the worst case data pattern 
(6DB6) on every sector and reads it back three times. If any errors are found they 
are reported and the track is flagged. 

F9—FORMAT DISK _ This performs a physical format of the hard disk 
and should not be confused with DOS format. If you are formatting a disk for the 
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first time then you should specify “‘y” to clear the defects, otherwise a quick scan 
will be made to identify any flagged tracks. After the format is done the tracks 
that were flagged as bad will be flagged again. 

FI0O—FLAG DEFECTS Some hard disk defects will be developed over 
time. This routine is used to flag those defects to prevent any data from being 
written there. 

A-F10—FORMAT TRACK _ The same as the format drive except it only 
formats one track. 


Miscellaneous Functions 

A-F9—TOGGLE PRINTER ON/OFF _ The printer can be used to log any 
errors. 

A-F10—EXIT __ Return to DOS 


Author/Source Jim Brackling, 967 Pinewood Ave., San Jose, CA 95129 
(408) 725-0628. 
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Commercial Programmer’s Tools 


EC EDITOR 

C Source, Inc. 

12801 Frost Rd. 

Kansas City, Missouri 64138 


EC Editor is a full-screen, fast editor that offers a complete set of utilities for 
the programmer. These include insert/delete, block moves, find/replace, search 
for string, ability to execute DOS commands in a buffer from within the pro- 
gram, use of up to five windows simultaneously, print spooling/formatting, and a 
macro facility. A calculator feature can provide hexadecimal/decimal/binary/ 
octal conversions. On-screen file comparison is easily accomplished. 
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HERE I describe a variety of utilities that patch and extend DOS to make it more 
streamlined and capable. 
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CACHE.COM 


Purpose Improves hard disk speed by buffering I/O. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features CACHE is a software program designed to increase the 
hard disk operating speed. This speed increase is accomplished by monitoring all 
disk accesses, and keeping the most recently accessed sectors in the RAM mem- 
ory allocated to the CACHE program. A common place to execute CACHE. EXE 
is in the AUTOEXEC.BAT file so that each time the computer is booted up a 
memory cache will be created. 

When DOS requests access to a sector, the CACHE RAM memory is 
checked first to see if the desired sector is already present. If so, the sector is 
returned to DOS without any disk accesses occurring. This greatly increases 
speed since RAM access is faster than disk access. If the desired sector is not 
present in CACHE RAM, it will then be read in to memory and placed into the 
CACHE RAM and returned to DOS. When this occurs, the least recently used 
sector in CACHE RAM is overwritten, this ensures that only the most recently 
used sectors will remain in the CACHE RAM. The more RAM memory allo- 
cated, the faster the system will run. 

The best way to install the CACHE is to place the CACHE command in your 
AUTOEXEC.BAT file so that it will be installed every time you boot your sys- 
tem. The CACHE command has the following format: 


CACHE [size] [-options] 
Where: 


size specifies the amount of memory, in K bytes, to allocate for the CACHE 
RAM buffer. The size specified must be greater than, or equal to, 8K. 


-options specifies one of the following: 


-a reactivate the CACHE 

-d deactivate the CACHE 

-s display the current CACHE status 

-u update the unwritten buffered sectors to disk 
-w activate buffered write mode 

-x deactivate buffered write mode 
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Options The -a and -d options are used to activate and deactivate the CACHE. 
When the CACHE is not active, all disk accesses are passed through without buf- 
fering anything in the CACHE RAM, as if CACHE was not installed. 

The -s option will display the current status of the copy of CACHE which is 
actually installed. It will tell you how much memory is allocated, whether the 
CACHE is active or not active, and whether buffered write mode is active or not 
active. 

The -w and -x options are used to activate and deactivate buffered write 
mode. Normally when DOS writes a sector to disk, it will be moved to the 
CACHE RAM and written to the disk before returning to DOS, which means 
CACHE does not increase the speed of disk writes. If buffered write mode is 
active, and DOS writes a sector to disk, it will be moved to the CACHE RAM 
and marked to be written to disk at a later time; return to DOS is immediate with- 
out the delay of the physical disk write. The buffered disk sectors will be written 
to disk when one of the following occurs: 


1) CACHE is deactivated. 
2) Buffered write mode is deactivated. 
3) CACHE -u command is issued. 


The -u option is used to update the hard disk by writing any unwritten buf- 
fered sectors to disk. 

Buffered write mode should only be used if the system is running on an unin- 
terruptible power supply. If for any reason the system loses power, gets reset, or 
is rebooted, and buffered write mode is active and the CACHE had not been 
updated your hard disk will be corrupted, which will require you to go to a 
backup. When using the CACHE in buffered write mode, make sure you issue 
the CACHE -u command before rebooting or powering off the system. 

If the FORMAT command is issued to format the hard disk while CACHE is 
active, CACHE will automatically deactivate. 


Examples The following would install the CACHE with a 256K RAM buffer: 
CACHE 256 

The following would display the status of the CACHE already installed: 
CACHE -s 

The following would deactivate the version of CACHE already installed: 
CACHE -d 
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The following would install the CACHE with a 180K RAM buffer and acti- 
vate buffered write mode: 


CACHE -w 180 


The following would update the unwritten buffered sectors onto disk (only 
needed if buffered write mode is active): 


CACHE -u 

The following would reactivate the cache and enable buffered write mode. | 
CACHE -aw 
Author/Source © 1984 Micro Designs International 
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CED.COM 


Purpose Memory resident editor for the DOS command line. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features | CED (which stands for Command EDitor) provides the 
following functions at the DOS prompt, or from within certain application pro- 
grams: 


e¢ Improved command line editing facility. 

¢ Recall of previously issued commands for re-entry. 

Command synonyms, which may include “chaining” of a series of 
commands. 

Parameterization of synonym commands. 

Recall of parameters for previously issued commands. 

User-settable buffer sizes for all functions. 

For programmers, a facility to add new “resident” commands to the DOS 
shell. 


Installation is accomplished by typing “CED” at the DOS prompt, or 
including the statement ‘““CED” in your AUTOEXEC.BAT file. There are 
optional parameters when installing CED; these will be covered later. After CED 
is installed, everything will appear to be normal, but you now have many new 
features when entering DOS commands. The remainder of this document will 
describe these features. 

CED is active either at the DOS prompt, or when an application program 
requests buffered keyboard input from DOS (DOS function OAH). There are a 
few such programs (DEBUG and EDLIN are two); but the main use of CED is at 
the DOS prompt. 

Once CED has been installed, the command ‘“‘CED” becomes an internal 
DOS command. Thus, when you want to issue CED commands (as explained 
below), you will type CED command, but the program file (CED.COM) need 
NOT be available on disk. CED becomes fully memory resident and is an exten- 
sion to DOS after installation. In particular, this means that you should NOT 
include a drive or path in issuing CED commands after initial installation. A 
command like C:CED SYN d dir will reload CED, which is probably not what 
you intend. 

Command line editor. CED provides a new “editor” for DOS commands. 
You will use this editor whenever you type a DOS command, or when you enter 
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data to a compatible program such as DEBUG. CED’s editor replaces all of the 
DOS editing keys, including F1-F5. 

There are two big differences between the CED editor and the DOS editor. 
First, the CED editor always allows you to see all of your data; where the DOS 
editor likes to “hide” characters, the CED editor always displays all of the char- 
acters that it is using. Second, the CED editor allows you to move the cursor 
around within a command, which makes correcting and altering commands 
much easier. The keystrokes that CED uses for editing are very similar to those 
used by many word processors and text editors; you will find command entry and 
editing to be much more natural than with the DOS editor. 

Typeover and Insert Modes. The CED editor has two basic modes: typeover 
mode and insert mode. In typeover (the normal mode), anything you type will 
add to or replace the text currently displayed. In insert mode, anything you type 
will be inserted into the text at the current cursor position, moving any characters 
to the right of the cursor out of the way. The Ins key toggles between typeover and 
insert modes. 

To demonstrate this, type some text at the DOS prompt, then use the left- 
arrow key to move the cursor into the text you just entered (note that the text is 
not erased; the arrow key simply moves the cursor). Now type a few characters 
and observe that they replace the text already there; this is typeover. Now press 
the Ins key once to enter insert mode (note that the cursor changes size to let you 
know that you’re in insert mode), and type some more text. Note that the new 
text is inserted into your ““command,” and the remaining text is moved right, out 
of the way. Press Esc to erase the command completely. 

Cursor Movement Keys. CED uses the following keys to move the cursor 
around within the command you are typing: 


Home Moves the cursor to the ‘“‘home’’ position—that is, to the first character. 

End Moves the cursor to the end position (following the last character dis- 
played). 

left Moves the cursor left one character. This does not erase any characters; 
it simply moves the cursor. Remember that left is the left-arrow key on 
the numeric keypad (key 4), not the Backspace key. 

right | Moves the cursor right one character. 

‘left Moves the cursor left one word. A “word” is any sequence of charac- 
ters bounded by one or more spaces; the cursor will be placed on the 
first character of the previous ‘‘word.” 

‘right | Moves the cursor right one word; it will be placed on the first character 
of the next word. 
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Text Deletion Keys. You can use the following CED editor keys to delete text: 


Del Deletes the character at the cursor position. 

Backspace Deletes the character to the left of the cursor position, and moves 
the cursor left. This is known as a destructive backspace; it is 
exactly equivalent to keying left arrow followed by Del. 

AEnd Deletes all characters from the cursor position to the end of the 
command. 

“Home Deletes all characters from the home position (first character) to the 
cursor position, not including the character at the cursor 
position. 

Esc Cancel: erases the command completely and allows you to start 
over. 


Copying From Template (EDLIN). When DOS or user programs such as 
EDLIN request input from CED, they provide it with an input “template.” In 
almost all cases, this template is a copy of the last command entered. The tem- 
plate is the data that is used by the DOS editing keys (< F1>-<F5>, etc.). 

CED users will not need this template very often, because the command 
stack (described below) provides a similar but much more powerful function. 
There are a few cases, however, when the template will be useful; the most 
important of these is seen in the DOS line editor, EDLIN. If you do not use 
EDLIN, this topic will probably not be of interest to you. 

When you are editing a previously entered line (by typing the line number at 
the EDLIN prompt), EDLIN places a copy of the line to be edited into the tem- 
plate. In order to allow you to edit the template directly, CED uses F3 to copy the 
contents of the template to the screen for editing. This is very similar in effect to 
F3 as used by DOS. So, when you want to edit an Edlin text line, type the line 
number, followed by F3. This is an example EDLIN session: 


C> edlin test 
End of input file 
“4, 3L 
1:*This is line 1 
2: This is line 2 
3: This is line 3 
‘2 
2:*This is line 2 
2 = 
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At this point, the test “‘This is line 2’’ is in the template, but it is not dis- 
played. To display the text and allow it to be edited, just press F3, and the screen 
will appear as follows: 


C> edlin test 
End of input file 
*1,3L 
1:*This is line 1 
2: This is line 2 
3: This is line 3 
*2 
2:* This is line 2 
2:*This is line 2_ 


As you can see, F3 performs approximately as it would under the DOS com- 
mand editor. 

F3 is available any time CED is active, but, in most cases, it will simply 
redisplay the last command entered. 

DOS Command Stack. CED keeps a record of each command you enter. You 
can retrieve and re-enter these commands by using the up and down keys to dis- 
play the old commands, then pressing Enter when the desired command is dis- 
played (the command can be edited, of course). 

You can visualize the stored data as a ‘“‘stack”’ of commands. CED keeps a 
pointer to somewhere in this stack. The pointer always points to a location 
“‘between”’ two commands; when you press up, CED displays the command 
“above” the pointer, then moves the pointer up one command. When you press 
down, CED displays the command “‘below”’ the pointer, then moves the pointer 
down one command. 

For example, suppose you have entered commands A, B, and C. The stack 
will appear as shown in Fig. 7-1. 


Fig. 7-1. This represents the stack after 
you have entered commands A, B and C. 


Pointer 
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The stack is circular in nature; thus, if the pointer points “below” the last 
command in the stack (as it does in Fig. 7-1), it is actually between the last com- 
mand (C) and the first command (A). In this situation, pressing up will display 
command C and leave the pointer between B and C. Pressing down will display 
command A, and leave the pointer between A and B. 

When you recall an old command and re-enter it without editing, the re- 
entered command is not added to the stack, and the pointer will drop one level. 
Suppose, for example, that you press up twice from the position in Fig. 7-1 
(pointer below C): B is displayed, and the stack looks like Fig. 7-2. 


Pointer —— 
Fig. 7-2. This shows the stack after 


pressing the up arrow twice. 


If you now press Enter (without editing the command), command B will be 
sent to DOS, and the pointer will drop to the point between B and C. From there, 
up will display B again, and down will display C. Thus you can “recycle” a 
series of commands by pressing up until you see the first command, Enter to exe- 
cute it, then a series of down Enter sequences to re-execute the commands in the 
original order. 

If you retrieve an old command and edit it before execution, the newly edited 
command is added to the bottom of the stack, and the pointer will point just 
below it. 

CED will not stack any commands of two characters or less (the theory 
being that it’s easier to retype than to go searching through the stack). 

You can remove a command from the stack by displaying it and pressing 
Ctrl-PgDn, and you can clear the entire stack by pressing Ctrl-PgUp. 

The actual number of commands which will be held in the stack is a function 
of the length of the commands and the size of the stack (which can be increased, 
see below for details). 

Application Program Command Stack. CED actually keeps two complete 
command stacks: one is for DOS commands, the other for commands entered 
into compatible application programs (DEBUG, et al). Thus, DOS commands 
will not appear in the command stack while in DEBUG, and vice versa. 
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Pcall function. “Pcall” stands for parameter recall; this is a second way to 
quickly retrieve old commands. Pcall simply remembers old parameters to spe- 
cific commands. For example, suppose you have an editor called “edit,’ and the 
last time you executed it, you used “edit c: \ util \ foo.doc.” If you now enter 
‘‘edit’’ without any parameters, CED will assume that you want to edit the same 
file and will supply the ‘“‘c: \ util \ foo.doc” for you. 

You could, of course, scroll back through the command buffer to find the old 
command, but it might take a while to find it (and the command might be missing 
if it was too long ago). 

Because many commands are best used WITHOUT parameter recall (FOR- 
MAT and ERASE are good examples), CED will only use pcall on commands 
that you specify. To make a command “‘pcallable,’ type 


CED PCALL command 


at the DOS prompt. For example, if you want to make “‘edit’’ a pcall command, 
type 
CED PCALL edit 


If you wish to issue a command for which pcall is enabled, but you do not 
want it to have parameters, add a space after the command. For example, sup- 
pose you have issued a CED PCALL dir command and your last dir was a “‘dir 
* exe’’. If you now type dir, CED will add the “**.exe”’ automatically. However, 
if you type dir (with a space), CED will not add the “**.exe”’, and you’ll get a full 
directory. 

Synonyms. The synonym function allows you to define brief “‘synonyms”’ for 
frequently used commands. For example, suppose you invoke your communica- 
tions package by typing talk rbbs /c63. CED allows you to abbreviate this to a 
shorter command, say, bb, by typing at the DOS prompt: 


CED SYN bb talk rbbs /c63 
The exact syntax 1s: 
CED SYN synonym command 


The synonym is the command abbreviation (which you will type at the DOS 
prompt), and command is the word or phrase that CED will substitute when it 
sees synonym. The synonym is always the first word after the keyword “‘syn”’ and 
command is always all of the remaining words. 

For example, CED syn d dir allows you to type d instead of dir. You may add 
parameters: d *.exe becomes equivalent to “dir *.exe’’. 
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Many people define very short synonyms for frequently used commands: 


CED SYN d dir 

CED SYN e edit 

CED SYN g debug 

CED SYN | link 

CED SYN rbbs talk rbbs /c63 
CED SYN cc1 cc1 -bpe 


Note in the last example that you can use a synonym that is identical to its associ- 
ated phrase and simply use it to automatically add parameters. Also note that syn- 
onym processing takes place AFTER pcall processing; thus if you use a 
command synonym and wish the command to be “‘pcallable,” use the synonym in 
the pcall command. For example: 


CED SYN e edit 
CED PCALLe (not PCALL edit) 


User Program Synonyms. Because CED “knows” whether it is being used 
from the DOS prompt or from an application program such as DEBUG, it is pos- 
sible to define separate sets of synonyms for DOS commands and for user pro- 
grams. The syntax for a “user synonym”’ is 


CED USERSYN synonym command 


This is identical to the SYN command except for the new keyword USER- 
SYN. For example, if you need to frequently type the DEBUG command d 
ds:1010 1200, you might use 


CED USERSYN d1 d es:1010 1200 


Remember that DEBUG is a CED-compatible program; thus you can type 
CED commands at the DEBUG prompt. Then you could simply type d1 to dump 
memory from the specified address. Note that a “dl” USERSYN is separate 
from a “dl”? SYN—at the DOS prompt you’d get the SYN, in DEBUG or 
EDLIN you’d get the USERSYN. 

Command Chaining. The command chaining feature allows you to place 
more than one command in a SYN or USERSYN. These commands would be 
passed to DOS or to the user program one at a time, as input is requested. Sup- 
pose, for example, that in order to run your communications package, you always 


type: 


cd \ talk 
talk cis /c63 
cd \ 
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You could put this sequence into one synonym by typing 
CED SYN cis cd \ talk‘talk cis /c63*cd \ 


The * character serves as a command separator. When you type CIS at the 
prompt, CED will output everything up to the * (in this case, “‘cd \ talk’’) and 
then simulate an Enter. The next time DOS requests input, it will Enter talk cis / 
c63 and so on. Note that CED will not pass DOS-chained commands to user pro- 
grams; thus, in 


CED SYN bug cd \util*debug*cd \ 


DEBUG would not see the trailing ‘““cd \’’, which would still be held up until 
you return to the DOS prompt. 

The first of the chained commands (e.g., the first “cd \ ’ above) cannot itself 
be a synonym, but the remaining commands can. That is, if ‘f and ‘g’ are syno- 
nyms, the command 


CED SYN h dir’f*g 
will work as you expect. However, a command like 
CED SYN f dir’f 


will put the computer into a loop from which there is no retreat. 

It may be useful in some circumstances, however, to fool CED into allowing 
the first command to be a synonym by simply inserting a * as the first character 
of the chain: 


CED SYN d dir 
CED SYN f *d’*cd \ 


When f is keyed, CED will first pass a null string to DOS, then dir and cd\ . 
This trick will work OK at the DOS prompt, but it may cause problems in some 
user programs (it would insert a blank line, for example, if you were in EDLIN 
line-insert mode). 

Limited “‘nesting’’ of chains is allowed. Consider the following definitions: 


CED SYN 1 a’b*c 
CED SYN 2 x‘1°z 


By executing 2 the commands issued will be x, a, b, c, and z. The limitation 
is that the stored commands ready for chaining must not exceed 512 characters 
total. In the above example, after you have keyed 2 and the **x”’ is passed to the 
operating system, the stored commands will be: 


1°z 
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which requires four characters of storage (three for the stored commands, plus 
one for a terminating carriage return). The next time CED is called, it will note 
that “‘1”’ is a synonym; the first ‘‘1’? command (‘‘a’’) is passed to the operating 
system, and the new stored commands will be: 


b*c*z 


which requires six bytes of storage. At no time can this list of stored commands 
exceed 512 bytes; characters pushed beyond the end of this storage will be lost. 
For whatever it’s worth, you can use chaining directly at the DOS prompt: 


C> dir’cd \ 


will work as you’d expect. 
You may alter the chain character (command separator) via the CED com- 
mand 


CED CHAINCH <char> 


So, for example, “CED CHAINCH &” would replace * with & as the com- 
mand separator. The chain character can, but probably should not, be a control 
character. If you are typing the command directly into CED, you can just type the 
control character: 


CED CHAINCH Ctrl-A 


However, if you are setting the chain character via configuration files 
(below), it may not be possible to type in the control character directly. For this 
reason, you can also specify a control character by typing the caret (* ) and a 
letter key. Thus, if you wanted to use *Y as the chain character, you would use 
*** and ‘Y”’: 


CED CHAINCH “Y 


Certain control characters should not be used for this purpose, because they 
are used for other functions by DOS; among these are *C (cancel), *G (bell), *H 
(backspace), “I (tab), ‘J (linefeed), “M (carriage return), *P (printer on), and “S 
(stop). 

The use of control characters as described has more meaningful use in set- 
ting the “‘ignore”’ and “‘status request” characters (below). 

Command Parameters. This section describes how synonyms and command 
chaining interact with command line parameters. The simplest case is a single 
word synonym like 


CED SYN d dir 


155 


Operating System Enhancements 


which specifies no special parameter handling. In this case, any command line 
parameters are simply tacked on after the synonym substitution: “d *.exe /w” 
becomes ‘“‘dir *.exe /w”’. 

If the synonym itself contains parameters: 


CED SYN dw dir /w 


a similar situation holds. For example, “dw *.asm” becomes “dir /w *.asm”’. 
You might think of these simple nonchained synonyms as just substitutions: when 
CED sees the synonym, it will simply substitute the replacement text, leaving the 
rest of the command line alone. This simple substitution, however, means that 
your command line parameters must always be the last text of the synonym. 
There would be no way, for example, to define a synonym that would obtain a 
directory of name.exe, where name is some filename entered on the command 
line and “‘.exe”’ is part of the synonym. That is, it would not be possible to define 
a synonym ‘‘d’’ such that the command. 


d foo 


would result in a “dir foo.exe” command. 

However, CED does provide a way to substitute parameters into the middle 
of a synonym. CED recognizes the ‘“‘%n”’ dummy parameter format used by 
DOS batch files. %1 represents the first command line parameter, %2 is the sec- 
ond, and so on, up to %9. Refer to your DOS documentation (batch file section) 
if this is unclear. Thus, a synonym which would provide the example function is: 


CED SYN d dir %1.exe 


When ‘“‘d foo” is executed, ‘‘foo’’ (the first command line parameter) is sub- 
stituted for the %1, resulting in the desired command “‘dir foo.exe”’. 

When a synonym contains chained commands, all parameter substitution is 
performed at one time, before the chain is started. Thus, 


CED SYN fa %1%b %2’c %3 
when executed ‘‘f one two three”’ will result in three commands: 


a one 
b two 
c three 


If a chain-command synonym contains no dummy parameters (no %’s) the 
commands line parameters will be appended to the end of the chain, i.e., as 
parameters to the last command. So, 


CED SYN f a*b*c 
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when executed ‘‘f foo”’ will result in the three commands: 


a 
b 
c foo 


You can change the dummy parameter character from ‘%’ to another charac- 
ter using the 


CED PARAMCH <char> 


command. The rules described for CHAINCH apply here. 

Ignoring Commands. There may be certain commands that you do not want 
CED to process; for example, you might not want the ERASE command stacked. 
To instruct CED to ignore a command, use the CED command 


CED IGNORE command 
For example: 
CED IGNORE erase 


When a command is set to IGNORE, CED will not place it in the command 
stack, check for synonyms, or perform any pcall processing (even if you have set 
PCALL for that command). 

Ignoring Individual Commands. You may sometimes want CED to ignore 
processing of a specific command. For example, you may have “dir” defined as a 
synonym for an external program that will display a sorted directory, but on occa- 
sion want to display a standard DOS directory. To force CED to suspend all proc- 
essing of a command, precede it with Ctrl-N. If the first character of input is 
Ctrl-N, CED will not stack the command, check for synonyms, or perform any 
pcall processing (just as if it were IGNOREd). The Ctrl-N, of course, is not 
passed to DOS or to the application program. For example: 


ANdir 


If you find “N inconvenient, you can change the ignore character to a differ- 
ent character by using the IGNORECH command: 


CED IGNORECH *T 
CED IGNORECH ! 


See the section on command chaining (above) for more information on how 
to enter control characters in this command. 
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Clearing CED Objects. From time to time it may be useful to clear a CED 
“object”: a pcall command, a synonym, or an ignore command. The CLEAR 
command allows you to do this. The formal syntax is: 


CED CLEAR function [ [FROM] name ] 


This looks more complex that it is. The function is one of SYN, USERSYN, 
PCALL, and IGNORE. Because the [ [FROM] name] is optional, the simplest 
form of the clear command is exemplified by: 


CED CLEAR SYN 
which will clear all synonyms. Similarly, 
CED CLEAR PCALL 


clears all pcall commands. 
You may clear an individual item by including its name. For example: 


CED CLEAR USERSYN foo 


clears the user synonym “foo,” leaving all other synonyms undisturbed. 
Finally, you can clear all items FROM a specified item through the end of the 
list with the FROM option. For example: 


CED CLEAR USERSYN FROM foo 


would clear the user synonym ‘“‘foo”’ and all synonyms listed after “foo.” This 
command is particularly useful if you have loaded a temporary set of synonyms 
for some special purpose. Suppose, for example, that you have a set of synonyms 
already in memory, then you load an additional set to be used temporarily. When 
you are done, the command 


CED CLEAR SYN FROM foo 


would delete all of the “‘temporary” synonyms, assuming that the first of these 
was “‘foo.” 

Note that SYN and USERSYN objects share storage. Thus, a CLEAR SYN 
FROM item or CLEAR USERSYN FROM item will clear all synonyms (of 
either type) FROM the named item. Similarly, CLEAR SYN and CLEAR 
USERSYN are functionally identical: all synonyms of either type will be cleared. 

Configuration Files. Obviously it would be inconvenient to have to type in 
all of these commands every time you use your computer. However, you may put 
any CED command into a special CED configuration file, and have them loaded 
all at once. The configuration file is simply an ASCII text file (created by your 
text editor, EDLIN, or word processor in nondocument mode) that contains a 
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series of CED commands. Just leave out the keyword ““CED,” but include the 
rest of the command: 


Rem Remarks are OK if preceded by “REM” 
Rem 

Rem Set chain char to *&’ 
Chainch & 

Rem Set ignore char to ‘!’ 
Ignorech ! 

Rem Set a few synonyms 

Syn d dir 

Syn e edit 

Syn cis cd \ talk & talk cis & cd \ 
Usersyn dd d ds:1017 LAO 


Rem And a few pcall commands 
Pcall e 
Pcall debug 


Rem Ignore all DEL, ERASE, and FORMAT commands 
Ignore erase 

Ignore format 

Ignore del 


To read in your file, use the CED -f command line switch: 

CED -F filename 

For example, if your configuration file is called CED.CFG, you'd use 
CED -Fc: \ boot \ ced.cfg 


If you load new configuration files during one computer session, the 
PCALL, SYN, USERSYN, and IGNORE commands are added to those already 
stored, without regard to duplication (see “Multiple definitions” below). 

Note that if you have several commands that you want to enter into CED (but 
don’t have them in a file), you can use 


CED -Fcon 


(which specifies CON: as the configuration file name) and then type a series of 
CED commands from the keyboard. Type *Z when you are done. 

Status Display. You may obtain a partial display of CED status any time CED 
is active (i.e., at the DOS prompt or in a compatible program awaiting input). Do 
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this by hitting Ctrl-T. CED will first display all SYNonyms and USER- 
SYNonyms, then a list of all buffer sizes. For each buffer, CED will show the 
total bytes allocated and the number of bytes free. When the display is complete, 
CED will redisplay any partial input that you typed before Ctrl-T, and you may 
continue data entry. If Ctrl-T is not convenient, you can change the status request 
character by using the CED command 


CED STATCH <character > 


as in ‘CED STATCH “A” or “CED STATCH %.” See the section on command 
chaining for more information on using control characters in this command. 

More advanced features, a technical description of the program, and distri- 
bution requirements appear on the diskette documentation supplied with CED. 
This documentation also notes a professional, commercial version of the program 
with source code. 


Author/Source Copyright © 1985, Christopher J. Dunford, 10057-2 Wind- 
stream Drive, Columbia, Maryland 21044 (301)992-9371. 
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FASTDISK.COM 


Purpose Speeds up disk drives. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features FASTDISK is a short utility program to speed floppy 
disk drive access times through a modification of DOS. All programs which run 
under your DOS should be compatible with FASTDISK. This program would be 
a good addition to your AUTOEXEC.BAT file. Invoke by typing FASTDISK at 
the DOS command prompt. 


Author/Source Unknown 
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HOTDOS.EXE 


Purpose Allows two programs to be loaded into memory and run alternately. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features HotDOS is a RAM-resident shareware program that 
emulates the commercially successful DoubleDOS program from SoftLogic 
Solutions. It creates two separately operating partitions in any PC with sufficient 
memory. It creates a DOS shell for programs that do not provide temporary 
access to DOS. By pressing the hotkeys, Ctrl-Left Shift, the currently-executing 
program is temporarily suspended so that a second copy of COMMAND.COM 
can be loaded and run in the foreground. Thus, two programs can be in memory 
simultaneously, but only the foreground program can actively process at one 
time. 

One can exit from the second partition back to the first by typing EXIT at the 
DOS prompt. Optional parameters available at the command line when executing 
HotDOS include: 


“G” or ‘‘g’’- For use on a system using the CGA display. This program will 
fully restore any CGA graphics screen at the expense of an 
additional 12K memory for use as a buffer. It will not restore 
an EGA graphics display, but is compatible with EGA text 
modes. 

“X” or “x”- For use on a system supporting both monochrome and CGA 
displays. This program will activate HotDOS on whichever 
display is not active when the Hot-Key is pressed. From that 
point on, the user can freely switch displays; HotDos will 
properly restore the display that was active prior to escaping 
to the HotDOS partition. 


This is an indispensible utility for those who require simultaneous viewing 
of two separate screens of data. As an example, one can run a text editor in the 
primary DOS partition, then switch to HotDOS for code compilation. This 
arrangement spares the nuisance of exiting and reloading the editor, as well as 
allowing viewing of compilation. This arrangement spares the nuisance of exiting 
and reloading the editor, as well as allowing viewing of compilation errors simul- 
taneous with editing the source code. 
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Both the ‘‘x” and “‘g”’ options can be combined when running HotDOS. To 
load, use the following syntax: 


HOTDOS [n] [/x] [/g] 
where n= requested size of HotDOS partition in Kilobytes (the default is 64K) 


Example 

HOTDOS (n=64K, no graphics, one screen) 
HOTDOS 100/g (n=100K, CGA graphics, one screen) 
HOTDOS 250 /x  (n=250K, no graphics, two screens) 
HOTDOS /x /g 75 (n=75K, CGA graphics, two screens) 


Do not load any RAM-resident application in the HotDOS partition. Doing 
so will destroy the integrity of the DOS allocation chain. All other resident soft- 
ware must be loaded in the primary DOS partition. Do not load any application 
that will overlay without checking for the top-of-memory location in the Program 
Segment Prefix. It is strongly suggested that you load HotDOS first among resi- 
dent applications. 


Author/Source Robert Best, 13681 Dall Lane, Santa Ana, CA 92705. A 
shareware contribution of $20 is suggested from satisfied users. 
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HUSH.COM 


Purpose Eliminate disk grinding noise under DOS 3.x. 
Hardware No special requirement. 
Software DOS 3.0 or later. 


Description/Features DOS 3.x has an error which causes floppy drives to 
have a “grinding” sound each time the drive is accessed. This problem does not 
exist in DOS 2.x. The grinding sound is caused by an incorrect step rate set on 
booting. 

The solution is to reset the step rate for floppy drives. The correct step rate is 
already part of DOS 3.x and through the use of the AX register and Interrupt 13 
the correction can be made. Set the AX register to zero with the instruction “‘xor 
ax,ax”’ and then call for “int 13.” This tiny program needs to end with “int 20” 
to return your system to DOS. 


xxxx:0100 xor ax,ax 
xxxx:0102 int 13 
xxxx:0104 int 20 


You can create this program with DEBUG or simply use HUSH.COM in your 
AUTOEXEC.BAT file. 


Author/Source C.D. Handlogen, 9235 Whitehurst, Dallas, TX 75243 
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MEMBRAIN.EXE 


Purpose RAM-disk utility program. 
Hardware Requires at least 128K memory. 
Software DOS 2.X. 


Description/Features _MEMBRAIN is used to create a RAM-resident disk 
drive or ‘“‘RAM-disk”’ of a user-specified size. The MEMBRAIN drive will sim- 
ulate a normal drive, but is extremely fast. RAM-disks are often used to store 
commonly referenced commands and data files for which access times are 
important. Normally such files are loaded to the MEMBRAIN disk by the 
AUTOEXEC.BAT file upon booting, or by application specific batch files. 

To create a RAM-disk using this program, enter MEMBRAIN followed by 
the Kbyte size of the desired RAM-disk. MEMBRAIN.EXE creates a file named 
‘MEMBRAIN.SYS, a DOS device driver for an emulated disk drive configured 
to your specifications. MEMBRAIN is installed through the DOS device driver 
interface using a ‘DEVICE= ’ statement in ‘CONFIG.SYS. DOS will assign to 
the drive the next available drive letter. For example, if your system has disk 
drives A: and B:, MEMBRAIN will be drive C:. On a PC-XT with drives A: and 
C:, MEMBRAIN will be drive D:. 

Installation—Step One. Enter on the DOS or QSYS command line: 

MEMBRAIN disk size, sector size, cluster size, directory entries, path disk 
size - The requested size of the emulated drive in Kbytes. An error is returned if 
the resulting configuration would leave less than 64K of free memory. If this 
parameter is omitted, the default disk size is 160K. 

sector size - The size of each logical sector in bytes. Sector size should be a 
multiple of 128 and will be rounded up to the next 128-byte multiple. For exam- 
ple, if the parameter is entered as 150, then the actual sector size will be 256 
bytes. The default is 512 bytes per sector. 

cluster size - The number of sectors per cluster. An error will be returned if 
the number of bytes per cluster exceeds 2048. Refer to ‘Configuration Tips ’ for 
more information. The default is 1 sector per cluster. 

directory entries - The maximum number of filenames that the disk directory 
can hold. This parameter will be adjusted upward as necessary to a multiple of 
sector size. The default is 64. 

path - The drive and directory path in which MEMBRAIN.SYS is to be cre- 
ated. This parameter is entered in the form “d: \ path ’. If drive is omitted, then 
the default drive will be used. If the path is omitted, then the current directory 
will be used. 
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Notes: 

- MEMBRAIN.EXE passes a return code upon termination that can be 
tested in a batch file with the ‘IF ERRORLEVEL ’ batch file command. A non- 
zero return code indicates that an error occurred. 

Installation—Step Two. To create a CONFIG.SYS file: 

Enter on the DOS command line: 


COPY CON: CONFIG.SYS 
DEVICE = MEMBRAIN.SYS 
Press F6 and then Enter 


CONFIG.SYS must be on the drive used to boot DOS. If you already use 
CONFIG.SYS, then edit it to include the statement ‘DEVICE = MEMBRAIN- 
SYS ’. Multiple ‘DEVICE = ’ statements can be used in CONFIG.SYS to load 
more than 1 MEMBRAIN device driver. This is less efficient than using a single, 
larger device driver, and is not supported by the QSYS INSTALLATION AID. 

Installation—Step Three. Re-boot DOS either by powering the system off 
and then back on, or key Ctrl-Alt-Del. The MEMBRAIN.SYS device driver is 
automatically loaded and initialized by DOS. 


Example MEMBRAIN.EXE displays a summary of disk space utilization as 
it creates MEMBRAIN.SYS. The following example illustrates how to use the 
data provided. 


MEMBRAIN 20,128,1,8,C: \ 


<<<< Mem Brain>>>> ‘Title 
© 1984 Dennis Lee 
20K MemBrain 


Created ‘disk size These are the 
values created, 

128 bytes per sector ‘sector size and may differ 

1 sector per cluster ‘cluster size from requested 

8 directory entries ‘directory entries values. 

1 reserved sector “boot record 

2 FAT sectors ‘file allocation table 

2 directory sectors ‘directory 

155 data sectors ‘usable file space 

160 total sectors ‘160 sectors X 128 bytes/sect = 20K 
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This summary can be used to analyze the overhead of the configuration. 
Because a change in the configuration has no effect until the next time DOS 
boots, MEMBRAIN.EXE may be executed several times to analyze the effects of 
different parameters. 

General Tips—Sector and Cluster Sizes. Each cluster requires 1.5 bytes of 
space for the file allocation table, and the total is rounded up to the next multiple 
of the sector size. The general rule for adjusting sector size and cluster size is to 
use small sector and cluster sizes for smaller drives, or when small files will be 
stored, because less space will be wasted when part of a cluster is left unused 
between files. Larger sector and cluster sizes might provide more usable disk 
space per Kbyte of disk size, and a slight performance gain with larger drives, or 
when a few large files are to be stored, because less space will be used for FAT 
sectors, wasted space between files is less of a consideration, and DOS will 
spend less time finding a given amount of data. 

General Tips—Directory Entries. Each directory entry requires 32 bytes of 
space, and the total is rounded up to the next multiple of sector size. For exam- 
ple, with 128 byte sectors, you get four directory entries per sector. Any request 
for directory entries would be rounded up to a multiple of four. The only key to 
allocate directory entries is to allocate slightly more than you think you’ll need, 
because it’s frustrating to have free disk space and no available directory entries, 
but not too many, because extra entries are wasted space. MEMBRAIN uses one 
directory entry for a volume label. 

Operational Characteristics. MEMBRAIN looks to DOS like a non-IBM 
fixed disk. This device type is used because it provides an operational interface to 
DOS consistent with its performance characteristics. The following list outlines 
its important operational characteristics. 


1) Because MEMBRAIN is a non-IBM device, the ‘FORMAT ’ command will 
not work with it. It doesn’t need to be formatted! 

2) Because MEMBRAIN can be any non-standard size, and is considered fixed 
media, ‘DISKCOPY ° will not work with it. 


Author/Source Dennis Less © 1984 
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POPDOS.EXE 


Purpose Memory resident access to DOS commands. 
Hardware No special requirement. 


Software DOS 2.0 or later. Not designed for use with programs that drive 
graphics display memory directly. 


Description/Features POPDOS is a memory resident DOS shell program 
which allows pop-up access to commonly used DOS commands. To use the pro- 
gram, type POPDOS at the DOS prompt or place POPDOS in your AUTOEX- 
EC.BAT file. POPDOS will be loaded in memory and available at any time by 
typing Alt-U. 

The functions provided by POPDOS are summarized below: 


Key Purpose 

Alt-U Pop-up POPDOS 

Esc Exit POPDOS 

Ctrl- Move POPDOS window to right/left of screen 


Ctrl-C Turn color on/off 
or Select a file 


Alt-F 
— Move menu bar up 
+ Move menu bar down 
Ctrl-E or Execute menu selection 
CR 
Fl HELP-provides a description of the select function key 
F2 CD- changes the default directory 
F3 DIR- lists the files on the specified directory. “‘*” and ‘*?”” may be 
used to indicate a range of files 
F4 XDIR- displays the beginning of the files on the specified drive. 
‘“«?? and ‘‘?” may be used to indicate a range of files 
F5 DEL- deletes the specified files. ““*’’ and ‘*?”’ may be used to indi- 
cate a range of files 
F6 COPY- copies files to a specific location. ‘**”’ and “*?”’ may be used 
to indicate a range of files 
F7 REN - renames a file 
F8 TYPE- displays the contents of a file. Press Ctrl-S to start/stop the 


listing. Press Esc to exit this command 
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F9 PRINT- use the following commands to control your printer: 

Fl HELP- information on the print command 

F2 FILE- print a selected file. Press Ctrl-S to start/stop the printer and 

Esc to exit 

F3 TW- TypeWriter. Print whatever you type at the keyboard. Use the 
Backspace to edit text 

F4 SET- select an EPSON typeface. If you have another type of 
printer, use F5/CODE instead 

F5 CODE- send printer control codes 

F10 CHKD- displays available disk space and available memory when 

POPDOS was loaded 


POPDOS is not compatible with certain programs which access video mem- 
ory directory (e.g. Microsoft WORD in graphics mode) and should not be 
invoked while running such programs. It may remain resident in memory, how- 
ever, until finished with the graphics program. 


Author/Source Jeffery Lill, SoftDesign, Inc., © 1984 Bellsoft, Inc. 
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XT.COM 


Purpose Repeats DOS commands over an entire directory tree. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features XT is a simple program that repeatedly executes com- 
mands over an entire directory tree, or over any specified subtree. The format for 
this command is: 


xt [d: ]path command [args] 
For example: 
xt \ db dir *.* 


XT, of course, runs the XT program. The \ db tells XT to start its directory 
search at directory ‘“‘\\ db” of the current drive. The dir *.* is just a normal dir 
* * XT will descend through the directory tree beginning at directory \ DB, 
and issue a dir *.* command for each subdirectory found. 

If the directory tree were as shown in Fig. 7-3, then XT would issue the fol- 
lowing commands: 


cd \ db \ dbprgs 
dir *.* 

cd \ db \ dbdata 
dir *.* 

cd \db 

dir *.* 


cd the current dir at the time xt was executed 


dirl 

db 
dbprgs Fig. 7-3. This is an example directory 
Apdaia structure. 

dir2 
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If you wish to execute a command over an entire disk, use the ““ \ ” root direc- 
tory: 


xt c: \ dir 


would display a list of all files on the disk (by issuing a DIR command in each 
subdirectory). 


1) You can use DOS’s “‘.” and “‘..” terminology to refer to the current directory 
and the current parent, respectively: 


xt . command(start search in current dir) 
xt .. command (start search in current dir’s parent) 


2) XT works by changing directories repeatedly. It will also change drives, if the 
specified tree is not the default drive. If you cancel XT before it is finished 
(via Ctrl-Break), you may find that your current drive or directory has 
changed. 

3) XT will use a secondary copy of the command processor (COMMAND- 
.COM or the current COMSPEC) if the command meets any of these criteria: 


a) It is an internal DOS command (but see “XT2”’ below). 

b) It contains piping or redirection. 

c) It is a batch file. 

d) The command contains any explicit extension other than COM or EXE. 

e) XT cannot find the command as a COM or EXE file in the current direc- 
tory or anywhere in the PATH. 


If none of the above is true, XT will execute the command directly (without 
reloading the command processor). 


Author/Source Copyright © 1985, Christopher J. Dunford, 10057-2 Wind- 
stream Drive, Columbia, Maryland 21044 (301)992-9371. Please refer to the 
documentation supplied on disk regarding the author’s requirements for distribu- 
tion. 
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Commercial Utilities 


PCED 

The Cove Software Group 
P.O. Box 1072 

Columbia, MD 21044 


PCED stands for Professional Command EDitor and is a utility designed to 
make the DOS command prompt more friendly. The arrow keys may be used to 
edit the command line; previous commands can be recalled using cursor up and 
then edited; and synonyms defined at the command prompt. Synonyms have 
access to the system time, date and current path. The program contains many 
enhancements to its public domain precursor, CED, and is felt by many to be an 
indispensable keyboard enhancer. 
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THE UTILITIES in this chapter provide useful commands to add new capabili- 
ties to your batch files. 
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ANSWER.COM 


Purpose Allows user to answer a question in a batch file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features Have you ever wanted to ask a question and get an 
answer that you could use in a batch file? This program is the ANSWER. The 
author found that he needed to ask for a directory and program name in a batch 
file he was writing, but discovered that there was no way to do it. He wrote 
ANSWER.COM to fill that need. 

The syntax for using ANSWER is as follows: 


ANSWER [optional prompt] 


ANSWER will display the optional prompt, and then accept input from the 
keyboard. It will place the input in your CURRENT ENVIRONMENT AREA in 
a field named ANSWER. If “ANSI.SYS”’ has been loaded, the optional prompt 
may contain any valid ANSI sequences to position the cursor, change color, etc. 
The user must have previously displayed some indication that keyboard input is 
expected or include the optional prompt to do so. If the optional prompt is not 
present, ANSWER will not display anything that would inform the operator that 
input is expected. 

Parameters in the environment area may be accessed similarly to command 
line parameters. 


Examples 


ANSWER filename 
COPY %ZANSWER% junk.dst 


ANSWER Enter the Drive the source file is on (including :) 
SET DRIVE= %ZANSWER% 


Note: This second example uses three parameters in the environment area. If 
you have not expanded your environment area, you may run out of space. 
ANSWER sets a return code which can be examined by the ERRORLEVEL 
option of the IF statement. ERRORLEVEL will be zero if ANSWER was suc- 
cessful, or one if there was insufficient room, or the environment area was cor- 
rupted. 


ANSWER Enter the path the source file may be found in (including following \) 
SET COPY PATH = % ANSWER % 
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ANSWER Enter the Source filename 
COPY %DRIVE% %COPYPATH% % ANSWER % junk.dst 


Author/Source Frank Schweiger, 10083 Heytesbury Ln, Sandy, Ut. 84092. 
The author can also be reached on the STATION ZEBRA Bulletin Board in Salt 


Lake City, Utah at (801) 561-4652. 
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ASK.COM 


Purpose Allows user input to yes/no questions in a batch file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features This command allows the user to set the batch environ- 
ment ERRORLEVELS interactively. A “‘prompt line’’ may be included with the 
command to ask a specific question. A yes (Y or y) response will set 
ERRORLEVEL to 0 and a no (N or n) response will set ERRORLEVEL to 1. 
Any other answer will cause “Y or N?”’ to appear. 


Example 
ASK 


displays ‘‘Press Y or N”’ on the console and waits for a keypress. 
A sample batch file demonstrating branching within a batch file based upon 
user input: 


ASK “PLEASE ANSWER YES (Y) OR NO (N)?” 
IF ERRORLEVEL 1 GOTO PRESSNO 

ECHO You pressed Y or y 

GOTO end 

:PRESSNO 

ECHO You pressed N or n 

end 


Author/Source © 1983, T. A. Davis. 
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FUNKY. BAT 


Purpose __ Use function keys to answer queries in batch files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features The purpose of the FUNKY utility is to allow the user 
of a Batch File to answer a prompting message or comment with any key that 
generates an ‘“‘extended” key code. Examples of such keys include the Function 
Keys Fl - F10 (also the shifted Ctrl and Alt Fl - F10), the Cursor Control 
(arrow) keys, and many other Alt and Ctrl key combinations. When the user 
answers the prompt with such a key, the FUNKY utility then sets the system 
“errorlevel” parameter so that a subsequent IF subcommand in the Batch File 
can branch accordingly. FUNKY will optionally execute some display formatting 
commands before it displays a prompt string. 

The format of the FUNKY command line is shown below, with the conven- 
tion that items in brackets [ ] are optional. 


FUNKY [/[cl[c2...]]/] [ string | 


where cl, c2, etc. are optional formatting commands enclosed in slashes. 

These commands are executed in the order they are encountered, before the 
string is displayed. The one-letter commands that are currently supported include 
the following: 


Borb_ Beep the console 
Lorl Skip one line 
Dord_ Display a “delimiting” border across the screen. 


After the ‘“‘slash” commands are executed, the string is displayed. If no slashes 
precede the string, the leading blanks and tabs are discarded. If slashes were 
present, then all characters after the second slash are displayed. The only con- 
straint on the string’s characters is that “‘<” and “|” and “>” must not be used 
in the string. Following the string, a reverse video “‘box” is displayed. When the 
user responds with a keystroke, the box ‘“‘un-reverses.” Usually, extended key- 
codes do not display on the screen. 

FUNKY then returns to the Batch File with the errorlevel parameter set to 
the extended code of the key that was struck. Representative examples of 
extended keys are as follows: 


59 -68 Function keys F1 - f10 (base case) 
71 Home 
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72 Cursor up arrow 
73 PgUp 

75 Cursor left arrow 
77 Cursor right arrow 
79 End 

80 Cursor down arrow 
81 PgDn 


If a key without an extended code (most alphanumeric and punctuation keys) is 
typed, then FUNKY returns the following errorlevel codes: 


0 If the key is Esc 

255 For any other ‘‘non-extended’’ key 
Example 

echo F1 SELECTION #1 

echo F2 SELECTION #2 

echo F3 SELECTION #3 

funky/IIb/ Please select one of the above : 


if not errorlevel 1 goto esc 

if not errorlevel 59 goto below 

if errorlevel 255 goto non_ext 

if errorlevel 62 goto higher 

if errorlevel 61 goto f3_typed 

if errorlevel 60 goto f2_typed 

echo —_ You pressed F1. 

goto continue 

:eSC 

echo ‘You struck Esc. 

goto continue 

>below 

echo _—- You pressed a key with an extended code >59 
goto continue 

:non_ext 

echo _ You pressed a non-extended key. 
goto continue 

=higher 

echo _—- You pressed a key with an extended code >61 
goto continue 

:f3_typed 

echo F3 RESPONSE HERE 
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echo F2 RESPONSE HERE 


:continue 


. Author/Source 


Warren Craycroft, 6236 Oakdale Ave., Oakland, CA 94605. 
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INPUT.COM 


Purpose Accepts user input within a batch file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features INPUT is a useful program for batch files which can 
prompt the user with a question and accept an alphanumeric response from the 
keyboard. The input must be a single key and can be any printable character. To 
invoke the program, type INPUT followed by the acceptable keyboard responses. 
The ERRORLEVEL will be set to a number corresponding to the position of the 
response in this list. 


Example 


ECHO OFF 

.This demonstrates the INPUT program 

.Use ECHO statements to create a menu, then branch on the 
keyin 

CLS 

ECHO EXAMPLE OF AN INPUT.COM MENU 


ECHO To do the first thing, press — A 

ECHO To do the second thing, press — B 

ECHO To do the third thing, press — 3 

ECHO To do the fourth thing, press — D 

ECHO To do the fifth thing, press — E 

ECHO ========s252s2522225555 5555555552525 
.Notice that the input can be any printable key (but forced 

to uppercase) 

INPUT “AB3DE” 

.Note that the IF ERRORLEVEL checks for error or HIGHER, so 
you must test 

.in reverse order (high first) — Esc always returns a 255 

value 7 

IF ERRORLEVEL 255 GOTO ESC 

IF ERRORLEVEL 5 GOTO FIVE 

IF ERRORLEVEL 4 GOTO FOUR 

IF ERRORLEVEL 3 GOTO THREE 

IF ERRORLEVEL 2 GOTO TWO 
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IF ERRORLEVEL 1 GOTO ONE 


“ESC 


ECHO You pressed the Esc key 


GOTO STOP 

:>ONE 

ECHO You pressed the A key 
.User can run a program here 
GOTO STOP 

:TWO 

ECHO You pressed the B key 
.User can run a program here 
GOTO STOP 

: THREE 

ECHO You pressed the 3 key 
.User can run a program here 
GOTO STOP 

:-FOUR 

ECHO You pressed the D key 
.User can run a program here 
GOTO STOP 

:FIVE 

ECHO You pressed the E key 
.User can run a program here 
GOTO STOP 

:STOP 


-Here, you can start another batch file with a different menu 


Author/Source Unknown 
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KEY-FAKE.COM 


Purpose Provides responses to programs invoked by batch files. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features KEY-FAKE.COM is a very useful batch file utility 
which provides set responses to queries from programs. One can specify any 
ASCII entry in quotes or the equivalent HEX value in the following format: 


Key-fake [‘‘any ASCII entry’’] [hex value without quotes] 
Examples 


cd \turbodir ‘changes to subdirectory 


66.,9? 


key-fake “‘y’’ ‘this is the first question turbo will ask 
turbo ‘this starts turbo pascal 
cd \ ‘this changes back to root directory 


key-fake ““Y”’ ‘these are the same things since 
key-fake 59 ‘the HEX ASCII value for Y is 59 


If you have a program that needs two entries where the first response requires no 
return key but the second one does, use: 


key-fake ‘X”’ “T”’ 13 
where the second entry “‘T”’ will require an Enter key (13) to help it along. 


Author/Source PC magazine, December 24, 1985, page 215. 
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SETPRN.COM 


Purpose Send control codes to printer from DOS or batch file. 
Hardware No special requirement. 
Software DOS 1.05 or later. 


Description/Features SETPRN provides an easy method of setting printer 
parameters from the DOS command level or a batch file. SETPRN is similar to 
the BASIC LPRINT command, except that control codes are enclosed in brackets 
instead of the ‘““CHR§( )’”’ used in BASIC. Also, text strings should not be 
enclosed in quotes. Like LPRINT, the normal carriage return/line feed can be 
suppressed by a trailing semicolon (“‘;”) or comma (“‘,’). A trailing semicolon 
will leave the print head at the end of the just-printed text, while a comma will 
advance the print head to the next tab stop. Any printable character may be 
included in the SETPRN command line except the left bracket which is used as 
the prefix to a control code. This character may be included by enclosing its 


ASCII code (91) between brackets—that is [91]. 


Examples The following examples assume that the file SETPRN.COM is on 
the default disk drive. Note that you should press the Enter/Return key after typ- 
ing the command. 


SETPRN Testing 0123456789 


This command will simply print the string “Testing 0123456789” on the 
printer and drop down to the next line. 


SETPRN Merry Christmas; 


This command will print the string ‘Merry Christmas” on the printer, but 
NOT drop down to the next line. Notice the trailing ‘‘;’’ which suppresses the 
carriage return/line feed. On some printers, “Merry Christmas” may not actu- 
ally be printed until an output is sent to the printer which contains a carriage 


return. 
SETPRN [27]E; 


This command will send Escape E to the printer. This sequence turns ON 
emphasized printing on the IBM and Epson dot matrix printers. 


SETPRN [27]!Boldface Title[27]” 


This command will print the string ‘Boldface Title’ in boldface on the C. 
Itoh and NEC dot matrix printers and drop down to the next line. With these 
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printers, Escape ! starts boldface printing and Escape ” stops boldface printing. 
Note that the double-quote symbol may be included in the SETPRN command 
line, just like any other character. 


Author/Source Vincent Bly, Post Office Box 409, Ft. Belvoir, VA, 22060 
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SFTPRTSC.COM 


Purpose Produces a screen print (Shft/PrtSc) from a batch file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SFTPRTSC.COM is a small utility to duplicate the 
PRINT SCREEN function in a batch file. To print the screen, simply call 
SFTPRTSC from the batch file. The program may be useful in applications 
where data on the screen can be “‘saved”’ by automatically printing it out from a 
batch file routine. 


Author/Source _R. Lee Beckley, Jr. 
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SIGNAL.COM 


Purpose Alerts user to press a key to continue batch file processing. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SIGNAL is designed to alert the user with continuous 

beeping that a batch file has reached a certain point. This might be useful for 

those who go off to do other tasks, but want to be called by the computer when a 

decision needs to be made or results are displayed. Often the operator leaves the 

computer when a program takes a long time to run, but wants to know as soon as | 
it is done; or sometimes part of a job can run unattended, but another part needs | 
operator input. The user is prompted to press any key before batch file processing 

continues. Functionally, this is just a noisy version of the DOS batch command 

PAUSE. 


Author/Source Martin Kelinsky. Published in PC World, October 1984, p. 
264, 265. 
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SKIPDOS.EXE 


Purpose Creates batch files to produce a custom menu at bootup and orga- 
nizes a hard disk. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SKIPDOS was written for those who prefer to see a 
menu at bootup, rather than be left at the DOS prompt. The program will create 
the necessary batch files in order to accomplish this task. 

To create the environment under which SKIPDOS will correctly operate, 
you must first create a subdirectory which will hold the files created by SKIP- 
DOS. This subdirectory should be on the logical drive where most of your appli- 
cations are located. All examples assume that you are using drive C: - If you are 
using a different drive the responses will, of course, be different. If you have only 
one logical hard drive, then this is where it must be. It is suggested that this 
directory be created from the root. In order to be sure that you are at the root 
directory, type the drive name and a colon, then press Return. Then, from the 


prompt, type: 
cd\ 


To see that you are in the root, now type cd and press Return. The response 
should be: 


Ges 


Now create the subdirectory. From the C> prompt, type: 
MD directory name 


At the prompt, now go to the new subdirectory by typing: 
CD\ directory name 

To be sure you’re there, type CD. The response should be: 
C:\ directory name 


Now copy the SKIPINST.EXE file into this directory. If you don’t know how 
to do this, consult the DOS manual. 


IMPORTANT: The name of your subdirectory will also be the name of the main 
batch file created by SKIPDOS. Be sure that there is no conflict with other pro- 
grams or subdirectories when naming your subdirectory. 
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After you have created the subdirectory where the SKIPDOS programs are to 
be located, you must set the DOS path so that SKIPDOS can find the proper 
place to write its files. If you currently have a path set, add the drive: \ subdirec- 
tory where the SKIPDOS files are to reside. If you do not have a path set or are 
unfamiliar with the command, do the following to set it now. From the DOS 


prompt, type: 
PATH =dr: \ subdirectory 


Before installing SKIPDOS, you must take an inventory of the applications 
that you have on your fixed disk(s), and make note of those that you wish to be 
able to access from the boot-up menu. While most applications lend themselves 
to this type of access, care should be taken that, in cases where more than one 
program must be run, you don’t tell SKIPDOS to take you back to the menu after 
running the first. This would be true for something like a compiler where after 
compiling a program, you must stay in the compiler subdirectory in order per- 
haps to run a linker. Note the number of fixed LOGICAL drives in your system, 
the subdirectories and the names of the applications within those subdirectories. 
An easy way to do this is to use the DOS command TREE and route the output to 
your printer. 

To install SKIPDOS, type SKIPINST at the C> prompt in the proper sub- 
directory. After the opening screen, you are asked to specify the number of LOG- 
ICAL fixed drives in your system. Because PC-DOS (MS-DOS) allows a 
maximum of 26 drives, that is what the program allows. The number of logical 
drives that you have is determined by the letter designations of your first through 
last FIXED drives. If your fixed drives are C:, D:, and E:, answer the question 
with 3. 

The next question asks the designations of your drives. Answer with the let- 
ter (NO COLON - the program adds that) of each fixed drive. DO NOT press 
Return after drive designations are entered. 

You are then asked for the TOTAL number of applications that you want to 
list on the menu. I suggest that, in addition to the applications you found when 
you did your inventory, you add one more called ‘Escape to DOS.” The program 
allows no more than 15 applications to be listed. 

SKIPDOS will then prompt you for the drive and subdirectory on which you 
want the SKIPDOS files written. Enter the drive letter and the subdirectory name 
which you just created. The name that you specify here becomes the name of the 
master batch file for the SKIPDOS program. If you enter a subdirectory that 


doesn’t exist, or one for which the PATH has not been set, you will be returned to 
the instruction screen for that module. At that point, you have the opportunity to 


escape to DOS, to create the subdirectory, or to set the PATH. 
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For each application specified above, SKIPINST then asks a series of ques- 
tions. The questions are the same for each. They should be answered as follows: 


NAME AS YOU WOULD LIKE TO SEE IT ON THE MENU: Anything 
goes—up to 18 characters. This is a text entry and has no influence on runtime. 

LOGICAL DRIVE WHERE APPLICATION LOCATED: Answer with 
only the letter designation of the logical drive (no colon). Only drives which 
were specified in the number of fixed drives module are acceptable. 

SUBDIRECTORY OF APPLICATION: Enter the name(s) of the subdirec- 
tory where the application is located. Omit the first backslash. However, if the 
application is deeper than one subdirectory, place a backslash (\) between the 
subdirectory names. If the application is located in the ROOT directory, press 
Return with no entry. 

DOS FILENAME OF APPLICATION: Enter the DOS filename of the 
application with no extension (only executable files; i.e. files with COM, EXE, 
or BAT extensions may be entered here.) If you do not wish to run a program, 
such as in an Escape to DOS, press Return with no entry. (Note: In the entries for 
Subdirectory and DOS filename, the program will accept ONLY valid DOS 
filenames. No more than 8 characters, and only the characters specified in the 
DOS manual are valid for filenames.) 

DO YOU WISH TO RETURN TO THE MENU AFTER APPLICATION: 
Answer (Y)es or (N)o depending upon whether return to the menu is appropriate 
from that application. 

After you have completed the questions for the last application, the text file 
which draws the screen is written to disk, and SKIPDOS is installed. 

If after running the entire program, you find that changes must be made, run 
SKIPINST again - Current batch and text files will be overwritten, and new ones 
created. 

In order to invoke SKIPDOS at boot-up, you must have a file on your BOOT 
directory (usually C: \ on XT’s) called AUTOEXEC.BAT. This file must con- 
tain the following entries for SKIPDOS to work properly: 


PATH = DRIVENAME: \ subdirectory 
drivename: 

cd \ subdirectory 

filename (same as subdirectory name) 


where drivename is the logical fixed drive where the SKIPDOS subdirectory is 


located, \ subdirectory refers to the subdirectory where the SKIPDOS files are 
located, and filename is the master BATCH file which invokes the procedures to 


use SKIPDOS. If you already have an AUTOEXEC.BAT program, these com- 
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mands must be added. If you do not have such a program, you must create one - 
see AUTOEXEC.BAT and PATH in your DOS manual. 


Author/Source William C. Rigney, AUTOMATED DATA SYSTEMS, INC. 
661 Bermuda Road, West Babylon, NY 11704. (516) 669-0522. 
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TOR.COM 


Purpose Issues Top-Of-Form command to printer from DOS or batch file. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features TOF is a short program to send the control characters 
to your printer to execute a Top-Of-Form command. This may be useful from 
DOS if your printer is located remotely and it would be easier to simply type TOF 
from the DOS prompt. Alternatively, this command may be useful in a batch file. 


Author/Source Mark Sawusch 
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WAITUNTL.COM 


Purpose Wait until a particular time arrives before continuing a batch file. 
Hardware No special requirement. 
Software DOS 1.1 or later. 


Description/Features This program can be used in batch files to simply wait 
until a certain time passes. The program continuously displays the current time, 
which makes it easy to compare to the time set in WAITUNTL. WAITUNTL 
makes it easy to trigger a series of events based on time, such as downloading 
data at 6 AM and running a series of reports at 6:15 to have ready when you get 
in. Times are specified in 24-hour format: 


WAITUNTL hh:mm:ss 

Example 

WAITUNTL 22:15:00 

would wait until 10:15 PM before continuing batch file processing. 


Author/Source Software Research Co. 
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WAKEUP.COM 


Purpose Executes a command string at a given time. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features WAKEUP.COM is a utility that will accept a time in 
hours:minutes:seconds and a command string of up to 200 characters. At the 
given time, the program will run the command string, which may be any DOS 
compatible command. 


Example WAKEUP could be used to activate your communications program 
to dial for stock quotes when the phone rates go down. It could activate a batch 
file at the same time each day. 


Author/Source Keith P. Graham 


Located on software diskette # . 
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Potpourri of 
Miscellaneous Utilities 


THIS CHAPTER includes a variety of unclassified utilities to jog your memory, 
unprotect programs, create a RAM-disk, jot electronic notes, and more! 


195 


Potpourri of Miscellaneous Utilities 


Lotus 1-2-3 Unprotector 


Purpose How to unprotect Lotus 1-2-3. 
Hardware No special requirement. 


Software DOS 2.0 or later, DEBUG, and Lotus 1 2 3 Versions 1, 1A, and 
2.0; 


Description/Features The utility routine described below is designed to be 
used with the DOS DEBUG program to remove copy protection from Lotus 1-2- 
3 versions 1, 1A, and 2.0. This will allow backup copies to be made and use of 
the program without a keydisk. 


1-2-3 Release I-A: 

1) Rename 123.exe 123.xyz 

2) DEBUG 123.xyz 

3) Type U ABA9 

4) You should see INT 13 at this address 
5) Type E ABAY 90 90 

6) Type W 

7) Type Q 

8) Rename 123.xyz 123.exe 


1-2-3 Release | 
1) Rename 123.exe 123.xyz 
2) DEBUG 123.xyz 
3) Type S DS:100 FFFF E8 BE 71 
The system will respond with xxxx:3666 where xxxx can vary 
4) Type E xxxx:3666 90 90 90 (xxxx is the number from above) 
5) Type W 
6) Type Q 
7) Rename 123.xyz 123.exe 


1-2-3 Release 1A* 

There is another version of Lotus 1-2-3 also called Release 1A but with a 
different copy-protection technique. It can be identified by an ‘“‘*”’ that displays 
on the first screen under the ‘‘s’’ in the word “‘Release’’: 

Release 1A 


* 
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To unprotect this version so it can be run on a hard disk without requiring the 
SYSTEM DISK in drive A, do the following: 


1) RENAME 123.EXE 123.XYZ 

2) DEBUG 123.XYZ 

3) Type U AB8C and press Enter. You should see “MOV CxX,0002”’. If you 
don’t, something is different and this won’t work. 

4) Type E AB8C C3 and press Enter 

5) Type W 

6) Type Q 

7) RENAME 123.XYZ 123.EXE 


If the above methods are unsuccessful in unprotecting release 1A, try the follow- 
ing: 
1) Rename 123.exe to 123.xyz 
2) Type (to DOS) the command 
C> debug 123.xyx 
3) Type (to debug) the command 
-s 100 efff cd 13 (The “-” is a prompt from debug.) 
4) Debug should respond with something like: 


xxxx: ABA9 
where xxxx is a hex number that may vary 

5) Type 
—e aba9 fb f9 (Use whatever debug gave you in the 
—W last step instead of “‘aba9”’ if it is 
-q different.) 


6) Rename 123.xyx to 123.exe 


1-2-3 Release 2.0 

1) Using your valid, original 123 diskette, install it on a fixed disk. You cannot 
use this text to unprotect the floppy directly. Softguard hides three files in 
your fixed disk root directory: CMLO203A.HCL, VDF0203A.VDW, and 
123.L2C. It also copies 123.COM into your chosen 123 directory. The exten- 
sion of 123.L2C does not matter; it is really an encrypted .EXE file. 

2) Un-hide the three files in the root directory. You can do this with the programs 
ALTER.COM—another utility program found in this book. Make copies of 
the three files, and of 123.COM, into some other directory. 

3) Hide the three root files again using ALTER (a public domain program 
described in this book). 
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4) Following the 123 instructions, UNINSTALL 123. You can now put away 
your original 123 diskette. 

5) Now copy your four saved files back into the root directory and hide and 
CML0203A.HCL, VDF0203A.VDW, and 123.L2C files using ALTER. 

6) Now you can run 123.COM using DEBUG, trace just up to the point where it 
has decrypted 123.EXE, then write that file out. 


debug 123.com ; name of file that runs the product 
r<cr> ; dump debug’s registers 


(Write down the value of DS for use below. 
This value is dependent on your particular machine.) 


g 4FA ; now trace CML 
t ; this step changes segments into CML 
g 1B5 
t ; change segments 
a 7D mov ax,cS _—_; assemble new instruction here over xor ax,ax 
e cs:E9 ; NOP out a mov ds,cx instruction 
8E.90 D9.90 ; when debug reports 8E. you enter 90 <space> 
; when debug reports D9. you enter 90 <cr> 
ecs:F5 ; change a jz instruction into a jmp 
74.EB ; debug reports the 74 here, you enter EB 
ecs:107 
8E.90 D8.90 > NOP out a mov ds,ax 
ecs:119 
8E.90 D9.90 > NOP out a mov ds,cx 
ecs:1AA 
CC:90 > NOP out an int 3 
glAA ; go to this address 
e cs:1E6 
CC.90 > NOP out an int 3 
e cs:200 
E8.90 FF.90 03.90 ; NOP out acall 602 
e cs:269 
26.2E ; change an es: to cs: 
e CS:26E ; change order of some pop instructions 
1F.5A 5A.59 5F.5B 5B.5F 5E.5E 59.1F 
e cs:1B6 
8E.90 DB.90 ; NOP out a mov ds.bx 


198 


ecs:1DD 
74.EB 
a 44C 
jmp 4BM 
a 53C 
jmp 455 
a 4E1 
mov bl,10 
e cs:500 
FE.90 C7.90 
e cs:52B 
8E.90 D9.90 
g 1E6 
t 
g 1E6 
g 290 
t 
g 24D 
t 
e cs:728 
8C.90 1F.90 
e cs:431 
89.90 07.90 
e cs:5BD 
75.90 03.90 
e cs:5F0 
89.90 17.90 
e cs:5D8 
74.EB 
g A41 
g AFA 
dcs:1F1 L8 
e xxxx 100 


3B.4D 2E.5A 


2E 
rBX <cr> 
(0 
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; change a jz to ajmp 


; jump to some needed code 


; jump back into main line code 


; provide correct checksum value 


> NOP out an inc bh 


* NOP out a mov ds,cx 


; trace through two passes 


; change segments 


; change segments 


- NOP out a mov [bx],ds 


; NOP out a mov [bx],ds 


; NOP out a jnz 5C2 


> NOP out a mov [bx],dx 


; change a jz to jmp 


- 123.EXE has been decrypted 

; just for grins, here’s the password ‘LOTUSKEY’ 
; where xxxx is the value of DS that 

; you wrote down at the beginning. 

; programs other than 123 rel. 2 may 

; have some numbers here other than 3B 


- set BX to 0 for 123 
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rCX <cr> 

"1000 ; set CX to 1C00 for 123 

n123.bin ; name of file to write to 

w xxxx:100 ; again xxxx is the original DS value 
q ; quit debug 


7) Unhide and delete the three root files CMLO203A.HCL, VDF0203A.VDW, 
and 123.L2C. Delete 123.COM and rename 123.BIN to 123.EXE. This is 
the unprotected 123 loader which runs the 123.CMP program. It could not be 
written out with the EXE. extension because DEBUG cannot write .EXE 
files. 
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MJOG.EXE 


Purpose Appointment reminder. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features Mog is a little program that can help jog your memory 
for important dates (mjog = Memory JOGger). You can use mjog to create a 
small file containing birthdays, appointments, etc., and it will start reminding 
you about them ten days in advance. Mjog is a good program to put in your 
autoexec.bat file. 

Adding Appointments to Your Calendar. To add a date to your calendar file 
(or to create a new file if there isn’t one already), just type 


mjog mm/dd/yy text 


where the mm/dd/yy is (obviously) the date, and text is whatever info you want 
displayed for that date. For example, if you type: 


mjog 4/13/88 Dinner with CPA 


mjog will add the note “Dinner with CPA” (on 4/13/88) to your file. 

If you leave out the year (“‘mjog 4/16 Find new CPA’), mjog will assume it’s 
an annual event and remind you every year. If you do include the year, you can 
use either yy (‘90’) or yyyy (‘1990’) format. If the year is less than 90, it’s 
assumed to be 20xx (like we’ll really be using MS-DOS machines in 2001). If 
you leave out both month and year (“‘mjog 12 Lunch with Trygve’’), mjog will 
assume that it’s an appointment for that day of the current month and year. That 
is, if mjog encountered a “12 Lunch with...” during May, 1988, it would be 
interpreted as 05/12/1988. 

Displaying Upcoming Appointments. To see if any important dates are com- 
ing up, just type “mjog.” It will list anything coming up within ten days. 

Optional Parameters. There are four optional switches that you may use 
when running mjog. These are: 


-L: by itself, displays a calendar of the current month. 
Format -L(mm) displays a calendar for the month mm of the current year. 
Format -L(mm/yy) displays a calendar of month mm/yy. 

-C: Cleans up the appointment file by deleting dates which have already passed, 
and entries without valid dates. 
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-n: nis a decimal number from 1 to 65535. This alters the number of days mjog 
will “look ahead” for displaying upcoming appointments. If you use -180, 
for example, mjog will display all appointments for the next 180 days. With- 
out a -n parameter, mjog looks ahead 10 days. 

-V: displays MJOG version number. 

The parameters may be used in any order, and they may be combined: 


mjog -c -I -180 
mjog -| -180 -c 
mjog -cl(3) -180 
mjog -180cl(2/87) 


are all valid. However, all parameters must precede any new notes you are 
adding at the same time: 


mjog -lc30 05/15/85 Project X due 


The mjog Data File. The file that mjog creates is called ‘“‘mjog.dat.” If 
mjog.dat will be in a directory other than the current (default) directory when 
mjog is run, you must inform the program where it is. Do this by including this 
statement in your autoexec.bat: 


set mjogdir =d: \ path 


For example, if the file is to be kept in directory C: \ UTILITY, include this 
statement in your autoexec file: 


set mjogdir=c: \ utility 


The data file is a standard ASCII text file, so you can edit it using your text editor 
if you wish. 

Calendar Screen Position. By default, the upper left corner of the calendar is 
located at screen coordinates (2,54), where the upper left corner of the screen is 
(0,0). You can alter the position of the calendar by issuing the DOS command: 


SET MJOGXY =x,y 


where x is the x-coordinate (0 to 79) and y is the y-coordinate (0-24). These val- 
ues are NOT checked by mjog, for maximum flexibility. The SET command will 
normally be placed in your AUTOEXEC.BAT; it will remain in effect for the 
entire computer session unless altered. 


Author/Source Copyright © 1985, Christopher J. Dunford, 10057-2 Wind- 
stream Drive, Columbia, Maryland 21044 (301) 992-937. 
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MORERAM.COM 


Purpose Increase memory available and speed power-up sequence. 


Hardware IBM-PC/XT. This software cannot be used with most PC compati- 
bles. 


Software DOS 2.0 or later. 


Description/Features This program has three purposes: 

1) Allow a PC to use more memory than is allowed via the motherboard 
memory switches (544K bytes for the 64K motherboard and 640K bytes for the 
newer 256K motherboard). 

2) Allow faster power-up sequence by setting the motherboard memory 
switch settings to 64K bytes installed. 

3) Patch the ROM BIOS data area to indicate that this PC has four floppy 
diskettes installed (instead of the normal two). This is for RAM disk emulation 
programs that require the motherboard equipment options switch to be set to 
include the number of RAM-disks. This is most notably required by the AST 
RESEARCH RAM-disk program called SUPERDRV. This code is commented 
out. To use it you must uncomment out the code and reassemble. Search for the 
string: 


sstub*** 


To use MORERAM, copy MORERAM.COM to your boot device (floppy or 
fixed). Next, create or edit your AUTOEXEC.BAT file found on your boot 
device to include MORERAM as the first program that will be executed. This is 
important because results are not guaranteed if MORERAM is not the first com- 
mand executed at boot time. Next, open the covers of your PC and set the mem- 
ory switches to indicate that your PC only has 64K. 

Now try rebooting your PC using Alt-Ctrl-Del. MORERAM will first dis- 
play a hello banner and the amount of memory DOS thinks your PC has (should 
be 64K.) Next, MORERAM will pause a second or two while it determines how 
much memory your PC really has. (It also clears this memory in the process to 
eliminate PARITY 2 errors later.) 

Once the physical memory limit is determined, MORERAM will display 
that amount and then automatically re-boot. The next time MORERAM is again 
executed from your AUTOEXEC.BAT, it will find that the amount of memory 
DOS thinks you have will be the same as that installed, and a reboot will be 
avoided! The program has been successfully tested with up to 704K (64K + 
512K + 128K) of memory. This requires placing memory into the semi-forbid- 
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den zone (segment A000) designated by IBM as “‘reserved.” This is acceptable as 
long as you don’t install memory beyond this into the BOOO segment where the 
monochrome and graphics display memory are located. 


Author/Source Daniel M. O’Brien, adapted from a PC-WORLD User-to- 
User column program of the same name. 
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PCWINDOW.COM 


Purpose SideKick clone with notepad, clock/timer, ASCII reference, color 
on/off, and printer set-up. 


Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features PCWINDOW is a memory resident utility which emu- 
lates the popular commercial program SideKick (Borland International). It pro- 
vides a pop-up notepad, clock/timer, ASCII character reference, color on/off, 
and printer set-up. To invoke the program, type PCWINDOW at the DOS prompt 
or include it in your AUTOEXEC.BAT file. 

The main menu is invoked by typing Alt-0. The functions of the program 
may also be used by typing Alt 1-8 directly without hitting Alt-0 first. The com- 
mand summary is: 


Alt-1 Time Display. shows the clock and timer functions in a box in the 
center of the screen. 

Alt-2 Start Timer. begins the timer when pressed. Useful to time long- 
distance phone calls or any other task. 

Alt-3 Split Timer. if timing multiple events, press this key combination to 
get the ‘‘stopwatch split time.” 

Alt-4 Stop Timer. stops the timer and displays time elapsed. 

Alt-5 Color On/Off. turns color on/off for the program display. 

Alt-6 ASCII Display. shows hex and decimal equivalents of all ASCII 
characters. Useful in sending control characters to printers and for 
programming. 

Alt-7 Notepad. small text editor with the following sub-commands: 


Alt-R reads a file 

Alt-W writes a file 

Alt-D inserts date 

Alt-T inserts time 

Esc exits file processing 
Alt-7 exits notepad 


The Home, End, Backspace, Ctrl-End, Insert, Delete, and arrow 
keys may be used for editing 
Alt-8 Printer Set-up. sends selected control characters to the printer. 


Author/Source Unknown 
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SIDEWAYS.EXE 


Purpose Prints wide documents sideways. 
Hardware EPSON/IBM or ThinkJet printer. 
Software DOS 2.0 or later. 


Description/Features SIDEWAYS allows printers to output text sideways 
down the length of a page. Wide reports or spreadsheets that don’t normally fit in 
the number of columns allowed across a page may be printed in this manner. 
SIDEWAYS prints existing text sideways, allowing unlimited print width. To 
invoke the program, type SIDEWAYS. The program will prompt you for the 
name of the ASCII text file to be printed and display text on the screen while 
printing. This program is similar to the commercial utility of the same name, 
although it does not allow the same degree of flexibility in formatting the printed 
output. 


Source Available on a single diskette from PC-SIG #523. See Appendix for 
address. 
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SILENCE.COM 


Purpose Turns off your computer’s speaker. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features SILENCE is a memory resident utility which reduces 
speaker noise to minimal clicks now and then whenever a program is attempting 
to drive the speaker. It is excellent to use with games for which the sound can’t be 
turned off. To invoke the program, simply type SILENCE at the DOS command 
prompt. 


Author/Source Carl Burtner, 435 Brandon Road, Rochester, NY 14622. 
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SWAPCOM.COM 


Purpose Switches the COM1 and COM2 serial ports. 
Hardware No special requirement. 
Software DOS 2.0 or later. 


Description/Features _SWAPCOM switches the serial ports COM1 and 
COM72 to redirect output. All output to COM1 is directed to COM2 and vice 
versa. The program may be useful to those who have two serial devices (two 
printers, for example) and are using a program which directs output to one of 
these ports exclusively. Running SWAPCOM will allow a choice of output device 
without having to reconnect cables. To return the ports to their original assign- 
ments, simply run SWAPCOM one more time. 


Author/Source Unknown 
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MISCELLANEOUS COMMERCIAL UTILITIES 


BROOKLYN BRIDGE 
White Crane Systems 
6889 Peachtree Ind. Blvd. 
Norcross, GA 30092 


Brooklyn Bridge allows two MS-DOS computers to connect via serial ports 
such that one is a slave or file server to the other. It is particularly useful to hook 
a portable or laptop computer to a desktop system to exchange files. The active 
machine, which can be either the desktop or laptop, uses the disk drives of the 
slave machine as though they were its own. One may copy or load for execution 
the files on the other system. This provides a simple way of converting to the 
newer 3!/2-inch disks by transferring files off your 5!/4-inch floppies without 
having to buy a 3!/2-inch drive for your desktop machine. 

Installation of the program is simple. A device driver is installed in the 
CONFIG.SYS files of both machines. A cable is hooked up between the serial 
ports of the machines and a program run to initiate the network on the slave. The 
master computer is then booted up, finds the network, and makes the connection. 
Otherwise, the device driver will be disabled and not interfere with the serial 
port. 


LIGHTNING 

Personal Computer Support Group, Inc. 
11035 Harry Hines Blvd., Suite 207 
Dallas, TX 75229 


Lightning is a disk caching utility that speeds your work by minimizing disk 
access. It selectively maintains data in memory buffers according to frequency of 
usage. When this data is requested, it can be readily fetched from the buffer 
rather than a considerably slower disk drive. Buffers are automatically purged 
when a particular diskette is removed. The user may select the amount of RAM 
to allocate for buffers, switch on or off a write-protection feature for a drive, and 
select which drives to have caching. 

The freeware program CACHE.COM performs a similar function and is 
also described in this book. 


SIDEKICK 

Borland International 
4585 Scotts Valley Drive 
Scotts Valley, CA 95066 
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SideKick is a RAM-resident utility of pop-up windows including a calendar/ 
appointment book, calculator, ASCII reference table, telephone directory, and 
notepad. These utilities may be accessed from within most application programs. 

The freeware program PCWINDOW.COM provides some of these features 
including pop-up notepad, clock/timer, ASCII character reference, color on/off, 
and printer set-up. The features provided only by SIDEKICK include a handy 
telephone dialer, calculator, and appointment book. 


SMART NOTES 
Personics Corp. 
2352 Main St. 
Concord, MA 01742 


Smart Notes is a RAM-resident utility which can annotate your files, includ- 
ing spreadsheets, word processor files, directories, and program listings. In this 
way, Smart Notes does to electronic files what 3M’s sticky Post-Its (TM) do to 
paper documents. The contents of the target file are not altered; notes are written 
to a separate file. They can be invaluable to document your work for future refer- 
ence or for other users. Smart Notes is similar to Note-Jt by Turner Hall Publish- 
ing, but is not limited to use with Lotus 1-2-3. 


THE SPREADSHEET AUDITOR 
Computer Associates International 
2195 Fortune Drive 
San Jose, CA 95131 


The Spreadsheet Auditor allows Lotus 1-2-3 and Symphony users to docu- 
ment and analyze their spreadsheets. Diagnostic tests may be used to check for 
references to blank cells, circular references, unused ranges, identical formulas, 
overlapping ranges, and other common errors. The spreadsheet may be displayed 
as separately formatted windows, a formula display, or symbolic map. A Cell 
Noter allows you to attach “‘notes”’ to spreadsheet cells to help in documenting 
and explaining the spreadsheet functions. These notes remain attached to a par- 
ticular cell as it is moved within a worksheet and may be printed separately. A 
sideways printing utility is also included. 
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Appendix 


Sources of Public Domain 
and Shareware Programs 


AP-JP Enterprises, Inc. 
P.O. Box 1155 
West Babylon, NY 11704 


Best Bits and Bytes 
P.O. Box 5332 


North Hollywood, CA 91616 


DISKoveries Unlimited 
14970 Circle Dr. 
Victorville, CA 92392 


Futuresystems 
Box 3040 
Vista, CA 92083 


Genesis Systems 
P.O. Box 406 
Claremont, CA 91711 


Gold Coast Computing 
P.O. Box 1257 
Secaucus, NJ 07094 


JDX DiskCopy Service 
P.O. Box 1561 
Corona, CA 91718 


The Label Factory 
P.O. Box 2856 
Glendale, AZ 85311 


Lighthouse Software 
P.O. Box 8718 
Norfolk, VA 23503-0718 


Lone Star Software 

2100 Hwy. 360 

Suite 1204 

Grand Prairie, TX 75050 


Micro Star 
P.O. Box 4078 
Leucadia, CA 92024-0996 


MicroCom Systems 
P.O. Box 51657 
Palo Alto, CA 94303 


MegaMicro Co. 


17 Bellevue Ave. 
Penndel, PA 19047 
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Morning Star Industries 
P.O. Box 3095 
Ann Arbor, Michigan 48106 


National Software Labs 
13376 Washington Blvd. #7 
Los Angeles, CA 90066 


North Country Consultants 
437 East 33rd St. 
South Sioux City, NE 68776 


PC-Blue 

Suite 3 

33 Gold St. 

New York, NY 10038 


PC-SIG, Inc. 
1030 E. Duane Ave., Suite D 
Sunnyvale, CA 94086 


Peoples Choice Public Domain Software 
P.O. Box 3061 
Warner Robbins, GA 31099 


Phoenix Systems 
P.O. Box 523 
Angola, IN 46703 


The Public Software Library 
P.O. Box 35705 
Houston, TX 77235 
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Sea-Bell Software Enterprises 
1380 156th E 

Suite 269 

Bellevue, WA 98007 


Shareware Express 
31877 Del Obispo, Suite 102 
San Juan Capistrano, CA 92693-0219 


Software Distributors Clearinghouse 
3707 Brangus 
Georgetown, TX 78628 


TimeMaster 
P.O. Box 4747 
Clearwater, FL 33518 


U. S. Disk, Inc. 
511-104 Encinitas Blvd. 
Encinitas, CA 92024 


US/PD Library 
226 N. Main St. 
Clinton, TN 37716 


Windward Public Software 
P.O. Box 4630 
Kaneohe, HI 96744 
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10 

compare, 3 

DOS commands in, 158 
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answer question in, 174 
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CAL.COM, 128 
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REMIND.COM, 130 
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COLOR.COM, 32 
colors 
CGA, fore- and background, 32, 
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commands 
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configuration files, DOS command, 
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CTRLALT.COM, 33 
Ctrl-Tab accessed commands, 50-53 
cursor, movement control/ 
enhancement, 71 


215 


Index 


custom menu, bootup, 187-190 
cut and paste from screen display, 35 
CUTPASTE.COM, 35 
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defragmentization, 117-119, 124 
diagnostics, hard disk, 140-141 
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add/delete/change, 102-103 
alphabetized listing, 90 
change drive, 102 
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hidden, 113 
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list files in, 120 
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print sorted, 92 
program with search capability, 4 
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DISABLE, 13, 16-17 
disk caching utility, Lightning, 209 
disk drives 
change, 102 
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locking, 71 
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DIRTREE.COM, 93 
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DS.EXE, 98-109 
DUPS.COM, 110 
LECOM, 111 
LIST2DAY.COM, 112 
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PROTECT.COM, 115 
RDSECRET.COM, 113 
RSUBDIR.EXE, 116 
SST.COM, 117-119 
TREEDIR.EXE, 120 
WHAT.COM, 121 
WHEREIS.EXE, 123 
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map of, 19 
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DOS 
command stack for, 150-152 
command synonyms for, 152-157 
directory and command shell, 98- 
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memory resident access to, 168 
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mand line, 147-160 
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prompt, user friendly, 172 
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backup of, 100-102 
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clusters in recovered, 25 
copy, 102 
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move, 105 
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print, 106 
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diagnostic routines for, 140-141 
organization of, 187-190 
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for, 144-146 
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HDDIAGS.COM, 140 
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IBM CGA on, 36-38 
Heyman, Alfred J., 119 
HGCIBM.COM, 36-38 
hidden directories, 113 
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Holzner, Steven, 20 
HOTDOS.EXE, 162 
HUSH.COM, 164 
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Karlton & Kendrick, 31 
KBFIX2.COM, 39-41 
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Cruise Control, 71 
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SPEEDKEY.COM, 62 
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Losoff, Alan, 120 

Lotus 1-2-3, unprotector utility for, 
196-200 


M 
Mace Utilities, 24 
macros, keyboard, 45, 57-60 
MAPMEM, 13, 15-16 
MARK, 12-15 
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Mason, Tim, 32 
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MEMBRAIN.EXE, 165-167 
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examine contents of, 134 
increase availability of, 203 
RAM-disk creation, 165-167 
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DOS command line editor, 147-160 
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CED.COM, 147-160 
commercially available, 172 
FASTDISK.COM, 161 
HOTDOS.EXE, 162 
HUSH.COM, 164 
MEMBRAIN.EXE, 165-167 
PCED, 172 
POPDOS.EXE, 168 
XT.COM, 170 
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paper, skip lines over perforations in, 
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71 
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RELEASE, 12-15 
remove from memory, 12-15 
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WHAT.COM, 121 

WHEREIS.EXE, 123 

White Crane Systems, 209 

wide documents, sideways printing of, 
206 

wildcards, 104 

Wilson, Richard, 34, 70 

write protection, hard disk, simulated, 
115 
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Notes Regarding 
the Free Distribution Diskette 


Due to space limitations, the free distribution diskette included with this book 
does not contain all of the programs described. A listing of programs NOT 
included appears below. Most of these programs are available from the authors, 
shareware suppliers listed in the Appendix, or from many electronic bulletin 
board services. If you are not able to obtain these programs from these sources, a 
diskette containing all of these programs is available for the costs of distribution 
from: 


SoftSource 
330 E. Cordova St., Suite #382 
Pasadena, CA 91101-2466 


Please indicate the disk desired and send check or money order for $4.95 for 
each diskette. 


Volume II: 

CTRLALT.COM 
HGCIBM.COM 
HGCIBM.COM 

HHDIAGS.COM 
HOTDOS.EXE 

MJOG.EXE 
NUNAME.COM 
PCWINDOW.EXE 
PRTCON.EXE 

SIDEWAYS.EXE 

SKIPDOS.EXE 
SMACS.COM 
SWEEP.EXE 
TREEDIR. EXE 
WHAT.COM 
XT.COM 


Volume III: 
ULTRA-UTILITIES 


Volume IV: 
ZIP.COM 


Volume V: 
TSR UTILITIES 


Note: Due to restrictions by the authors, LIST.COM and NEWKEY.EXE are 
only available by writing the author directly at the addresses listed within the 
book. 
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MICROCOMPUTER LANs: Network Design and 
Implementation—Michael F. Hordeski 

This much-needed guide will show you how to ap- 
ply low-cost computer networks as solutions in office au- 
tomation, in the control and monitoring of factory 
production, and in the provision of management infor- 
mation. It will show you what network applications are 
possible, how to implement a multi-user system, even how 
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347 pages, 119 illustrations. Book No. 2888, $24.95 
paperback, $32.95 hardcover 


TELECOMMUNICATIONS MANAGEMENT 
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tions and personnel involved in establishing product line 
strategies. 752 pages, 243 illustrations. Book No. 2864, 
$32.95 paperback, $49.95 hardcover 


MICRO TO MAINFRAME DATA 
INTERCHANGE —Michael Simon Bodner, Ph.D. 

A single reference that addresses the ‘‘BIG’’ picture 
of integrating micro, mini, and mainframe computer data, 
file structure, data communications, inter application ex- 
change, and data security. The information contained in 
Micro to Mainframe Data Interchange has been compiled 
with medium-to-large computer systems in mind, and ex- 
amines, with examples and case studies, methods of de- 
veloping interapplication data file interchanges. 274 
pages, 139 illustrations. Book No. 2940, $19.95 paper- 
back, $26.95 hardcover 


SYSTEMS DESIGN UNDER CICS COMMAND 
AND VSAM—Alex Varsegi 

Here is a comprehensive summary of CICS functions, 
design considerations, and related software products to 
acquaint you with the concept of on-line data processing 
and its established role in current computer design. You’ll 
cover system design, screen painting techniques using 
SDF to create input/output maps, the use of CECI, VSAM 
(virtual storage access method), all the CICS commands 
and how they relate to system design. 272 pages, 204 il- 
lustrations. Book No. 2843, $23.95 paperback, $28.95 
hardcover 


From the Software Engineering Series . . . 
HANDBOOK OF DIAGNOSING AND SOLVING 
COMPUTER PROBLEMS—William E. Perry, CQA 

The purpose of this book is to provide the corrective 
process you need to identify computer problems, diag- 
nose the causes, and apply effective solutions. Through 
practical discussions and illustrative examples, the author 
examines ten problems that most often confront computer 
users on all levels, including: organizational disputes, 
limited system capacity, misuse of systems, unusable out- 
put, disaster situations, software bugs, and more. 276 
pages, 47 illustrations. Book No. 3233, $19.95 paper- 
back, $25.95 hardcover 


MICROPROCESSORS IN INDUSTRIAL MEAS- 
UREMENT AND CONTROL—Marvin D. Weiss 

A practical introduction to the application of 
microprocessors to the measurement, control, and auto- 
mation of industrial processes. Starting with a look at the 
roots of digital systems-Weiss traces the evolution of con- 
trol and automation in the process industries. Also co- 
vered is the development of control hardware and 
software. 432 pages, 97 illustrations. Book No. 2818, 
$22.95 paperback, $29.95 hardcover 


ISDN IN THE INFORMATION MARKETPLACE— 
Robert K. Heldman 

This book covers integrated services digital networks 
from ideology to conceptual reality. It explores the capa- 
bility for worldwide communication through computers 
on four levels: voice, data, video, and images, and exa- 
mines the far-reaching effects this technology will have 
on the world’s business, military, science, and education 
industries. ISDN services will soon become available on 
an international basis via a global network system. 333 
pages, 108 illustrations. Book No. 3015, $26.95 paper- 
back, $34.95 hardcover 


80386—A PROGRAMMING AND DESIGN 
HANDBOOK—Penn Brumm and Don Brumm 

The basis of IBM’s OS/2 operating system and their 
new Personal System 2 computers, the 80386 
microprocessor promises new standards in microcomputer 
power, speed, and versatility. Now, with the coopera- 
tion of 80386 designers from Intel Corporation, Penn and 
Don Brumm have provided the first complete sourcebook 
on this advanced processor, including its capabilities and 
information for programmers and designers. 448 pages, 
97 illustrations. Book No. 2937, $16.95 paperback, 
$19.95 hardcover 


Other Bestsellers of Related Interest 


WORKING WITH ORACLE®: An Introduction to 
Database Management—Jack L. Hursch, Ph.D., and 
Carolyn J. Hursch, Ph.D. 

This easy-to-understand guide shows you how you 
can use the ORACLE database management system to 
open the lines of communication between all the com- 
puters in your company—micros, minis, and mainframes. 
The ideal supplement to the user’s manual, this book ad- 
dresses all the standard operations and features of ORA- 
CLE version 5.0 with instructions on ORACLE’s query 
language, SQL. 240 pages, 35 illustrations. Book No. 
2916, $16.95 paperback, $19.95 hardcover 


NETWORKING WITH THE IBM® TOKEN- 
RING—Carl Townsend 

Now, with publcation of this excellent handbook you 
have the opportunity to discover for yourself what Token- 
Ring is all about, how it works, and how you can use 
the network to accomplish specific production goals. 
Townsend introduces you to local area networking—types 
of LANs, their components, and LAN rules and conven- 
tions. Then, he takes you step-by-step through the plan- 
ning, preparation, acquisition, installation, and operation 
of a Token-Ring. 200 pages, 89 illustrations. Book No. 
2892, $13.95 paperback, $16.95 hardcover 
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hareware and public domain programs can accom- 
plish the same tasks as commercial utilities, while saving 
you hundreds of dollars. By its very nature, however, the 
world of user-supported software depends largely on word- 
of-mouth and “‘insider trading.’’ Now you can tap into this 
vast market with the help of Mark Sawusch. He shows you 
how to pick the software gems from among the thousands 
of entries and explains how they compare to commercial 
software and one another. 


In The Best of Shareware: IBM® PC Utilities, Sawusch 
provides: 


» Complete information for over 100 of the best IBM PC 
public domain and shareware utilities 


» An evaluation of the advantages and limitation of each 
program, as well as how to use it most effectively 


6 Complete command and feature summaries and 
example applications for each 


PA listing of the programs’ distributor names and 
addresses, and suggested registration fees 


» A disk containing 75 of the most useful programs 
covered in the book 


Discover how you can 
get fast, efficient, 
inexpensive software! 


ee ee 
About the Author 


Mark R. Sawusch is an 
experienced computer 
programmer and consultant 
who has been a ‘‘pioneer’’ of 
the personal computing field. 
He has written several articles 
for computer magazines and is 
the author of 1001 Things To 
Do With Your Personal 
Computer (Book No. 1160). 
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